Saltar al contenido

Crear App Google Home Assistant: Guía Paso a Paso 2026

25/12/2023

Actualizado el 20 de marzo de 2026

En el ecosistema de la automatización del hogar de 2026, crear una aplicación de Google personalizada es un paso fundamental para desbloquear una integración profunda y robusta con Home Assistant. Ya no se trata solo de comodidad; es la clave para una gestión de datos privada y un control sin intermediarios sobre servicios esenciales. Este artículo es la guía definitiva que te llevará de la mano por el proceso en la Google Cloud Platform, permitiéndote conectar servicios tan potentes como Google Calendar o Google Fit directamente a tu instancia de Home Assistant.

A lo largo de esta guía actualizada, he desglosado cada etapa del proceso: desde la creación de tu proyecto en la consola de Google y la generación de las credenciales de Google mediante OAuth 2.0, hasta la habilitación de la API de Google específica que necesites. Te explicaré con un enfoque práctico por qué cada configuración es crucial y cómo contribuye a una integración segura y eficiente. Con estos conocimientos, estarás perfectamente equipado para llevar tu hogar inteligente al siguiente nivel, aprovechando al máximo la sinergia entre los servicios de Google y el poder de Home Assistant.

Crear una aplicación de Google en 2026

Paso a Paso para Crear tu Aplicación de Google en 2026

  1. Crear un Proyecto en Google Cloud Platform
    • Accede a la Consola de Google Cloud. Es el centro de operaciones para todos los servicios de desarrollador de Google.
    • Crea un «Nuevo Proyecto» y asígnale un nombre fácil de identificar, como «Home Assistant Integraciones».
    • Una vez creado, asegúrate de que esté seleccionado en la parte superior de la consola.
  2. Configurar la Pantalla de Consentimiento OAuth
    • En el menú de navegación, ve a «APIs y servicios» > «Pantalla de consentimiento de OAuth». Esta pantalla es lo que verás al autorizar a Home Assistant a acceder a tus datos.
    • Selecciona el tipo de usuario «Externo» y haz clic en «Crear».
    • Rellena los campos obligatorios:
      • Nombre de la aplicación: El nombre de la integración (ej. «Integración Calendario HA»).
      • Correo electrónico de asistencia al usuario: Tu dirección de correo.
      • Información de contacto del desarrollador: Tu misma dirección de correo.
    • Haz clic en «Guardar y continuar». En las siguientes pantallas («permisos» y «usuarios de prueba») no es necesario añadir nada por ahora, así que puedes pulsar «Guardar y continuar» hasta volver al panel.
  3. Habilitar la API Necesaria
    • Vuelve al panel de «APIs y servicios» y selecciona «Biblioteca».
    • Busca y selecciona la API del servicio que quieres integrar (por ejemplo, «Google Calendar API» o «Fitness API» para Google Fit).
    • Haz clic en el botón «Habilitar» para activarla en tu proyecto.
  4. Publicar la Aplicación
    • Regresa a «Pantalla de consentimiento de OAuth». Verás que el estado es «Pruebas».
    • Haz clic en «Publicar la aplicación» y confirma. Esto permite que la autenticación funcione de forma persistente sin necesidad de añadir usuarios de prueba.
  5. Crear las Credenciales de OAuth 2.0
    • En el menú lateral, ve a «Credenciales».
    • Haz clic en «Crear credenciales» y selecciona «ID de cliente de OAuth».
    • En «Tipo de aplicación», elige «Aplicación web».
    • Asigna un nombre (ej. «Credenciales Web HA»).
    • En la sección «URI de redireccionamiento autorizados», añade la siguiente URL: https://my.home-assistant.io/redirect/oauth. Este es un paso crítico que le dice a Google a dónde devolver la autenticación exitosa.
    • Haz clic en «Crear». Se mostrará una ventana con tu ID de Cliente y tu Secreto de Cliente. Cópialos y guárdalos en un lugar seguro. ¡Los necesitarás en Home Assistant!

¿Necesitas Siempre Crear una Aplicación? Alternativas en 2026

Aunque crear tu propia aplicación de Google ofrece el máximo control y privacidad, es justo preguntarse si siempre es necesario. En 2026, el ecosistema de Home Assistant es más maduro. Algunas integraciones oficiales o disponibles a través de HACS pueden venir con claves de API preconfiguradas por el desarrollador.

Sin embargo, mi recomendación como ingeniero es clara: siempre que sea posible, crea y utiliza tus propias credenciales. ¿Por qué? Porque las claves compartidas están sujetas a cuotas de uso globales. Si muchos usuarios utilizan la misma clave, el servicio podría dejar de funcionar temporalmente. Al usar tus propias credenciales, solo compites contra tu propio uso, garantizando una mayor fiabilidad para la automatización del hogar.

Solución de Problemas Comunes (Troubleshooting)

Durante el proceso, es posible que te encuentres con algún bache. Aquí he recopilado los errores más comunes y cómo solucionarlos rápidamente:

Error ComúnCausa y Solución
Error 400: redirect_uri_mismatchEste es el error más frecuente. Significa que la URL de redireccionamiento en tu configuración de Home Assistant no coincide exactamente con la que autorizaste en la Google Cloud Platform. Revisa el paso 5.5 y asegúrate de que https://my.home-assistant.io/redirect/oauth esté escrita idénticamente en tus credenciales.
Error 403: access_deniedSuele ocurrir si no has publicado la aplicación (Paso 4). Si tu app está en modo «Pruebas», solo los usuarios que hayas añadido explícitamente podrán autorizarla. Publica la aplicación para eliminar esta restricción.
La integración funciona pero se desconectaSi la autenticación caduca a los pocos días, es probable que no hayas publicado la aplicación. Las aplicaciones en modo de prueba tienen tokens de actualización que expiran rápidamente.
API no disponible o error de permisosVerifica que has habilitado la API correcta en la Biblioteca de Google Cloud (Paso 3). Por ejemplo, para Google Calendar, necesitas la «Google Calendar API», no otra similar.

Mejores Prácticas de Seguridad para tus Credenciales de Google

La seguridad de tus credenciales es tan importante como la de la contraseña de tu casa. Al fin y al cabo, dan acceso a tus datos personales. Sigue estas recomendaciones para mantener tu integración segura:

  • Usa secrets.yaml: Nunca escribas tu ID de Cliente o Secreto de Cliente directamente en tu archivo configuration.yaml. Utiliza el archivo secrets.yaml de Home Assistant para almacenarlos y referenciarlos. Esto evita que expongas tus credenciales si compartes tu configuración.
  • Limita los Permisos (Scopes): Aunque en esta guía no entramos en detalle sobre los permisos, si una integración te permite definirlos, solicita solo los necesarios. No des acceso de escritura si solo necesitas leer datos del calendario.
  • No compartas tus credenciales: Trata tu Secreto de Cliente como una contraseña. Nunca lo publiques en foros, GitHub o cualquier otro lugar público.
  • Revisa los accesos periódicamente: Desde la configuración de seguridad de tu cuenta de Google, puedes ver qué aplicaciones tienen acceso a tus datos. Es una buena práctica revisar esta lista de vez en cuando y revocar el acceso a servicios que ya no utilices.

Implementar estas medidas te ayudará a construir un sistema de domótica no solo potente, sino también robusto y seguro, protegiendo tu privacidad y la de tu familia. Para más información sobre cómo proteger tu red, te recomiendo leer mi guía sobre los riesgos de la red doméstica.

Preguntas Frecuentes (FAQ)

  1. ¿Qué conocimientos técnicos necesito en 2026?
    Respuesta: Aunque tener una noción básica de qué es una API y OAuth 2.0 ayuda, no es imprescindible. Siguiendo esta guía paso a paso, he simplificado el proceso para que sea accesible incluso si no tienes experiencia previa en la Google Cloud Platform.
  2. ¿Cómo garantizo la seguridad de mi aplicación de Google?
    Respuesta: La clave es proteger tu ID de Cliente y, sobre todo, tu Secreto de Cliente. Utiliza siempre el archivo secrets.yaml en Home Assistant y nunca compartas estas credenciales.
  3. ¿Puedo usar una sola aplicación de Google para varias integraciones en Home Assistant?
    Respuesta: ¡Sí! Puedes y debes usar la misma aplicación. Simplemente habilita las diferentes APIs (Calendar, Fit, etc.) que necesites para tu proyecto en la Biblioteca de Google Cloud. No necesitas crear un proyecto nuevo para cada integración.
  4. ¿Qué hago si me sale el error «redirect_uri_mismatch»?
    Respuesta: Este error significa que la URL en la configuración de tus credenciales de Google no coincide con la que Home Assistant está usando. Asegúrate de haber añadido «https://my.home-assistant.io/redirect/oauth» en la sección «URI de redireccionamiento autorizados» de tu ID de cliente de OAuth.
  5. ¿Este proceso tiene algún coste?
    Respuesta: Para el uso típico en automatización del hogar, el uso de las APIs de Google entra dentro de la capa gratuita. No deberías incurrir en ningún coste por integrar servicios como Calendar o Fit en Home Assistant.

Conclusión

Crear tu propia aplicación de Google para Home Assistant es un proceso que ha madurado y se ha vuelto más accesible en 2026. Aunque requiere seguir unos pasos concretos, los beneficios en términos de fiabilidad, control y privacidad son inmensos. Al gestionar tus propias credenciales de Google, te aseguras una integración robusta que no depende de cuotas de terceros, poniendo el verdadero poder de la automatización del hogar en tus manos. Siguiendo esta guía, he comprobado que cualquier usuario puede lograr una conexión directa y segura, transformando por completo su experiencia con el hogar inteligente.

Sígueme a YouTube

Sígueme en YouTube - Home Assistant 2026