Descubrimiento de apps y vínculos directos

Google Home app (GHA) es la forma principal en que los usuarios conectan dispositivos inteligentes a Google Assistant y los asignan a estructuras y habitaciones en Google Home Graph. Para realizar la configuración, los usuarios suelen hacer clic en varias pantallas para encontrar tu integración de Cloud-to-cloud en una lista de opciones disponibles. Si facilitas que los usuarios comiencen el proceso de configuración, puedes ayudarlos a integrarse más rápido y reducir su frustración.

Para optimizar la integración de los usuarios en dispositivos smart home, la plataforma smart home de Google ofrece varias funciones convenientes que permiten que los usuarios ingresen rápidamente al flujo de configuración y comiencen a usar su dispositivo smart home. Estas funciones se pueden integrar fácilmente en tu integración de Cloud-to-cloud con poco o ningún esfuerzo de programación.

En la siguiente lista, se resumen las funciones de la plataforma que puedes implementar para reducir los inconvenientes de los usuarios cuando configuran tus dispositivos inteligentes para Assistant:

  • App Discovery: Esta función permite que los usuarios vean chips de sugerencias para vincularse a tu integración de Cloud-to-cloud en GHA. Si hacen clic en el chip, pueden conectar sus dispositivos smart home a Assistant con sus cuentas de proveedores externos.
  • Vínculos directos: Esta función te permite incorporar un vínculo directo en tu app o sitio web del producto para que los usuarios conecten fácilmente su dispositivo smart home a Assistant. Si los usuarios hacen clic en el vínculo, se les pedirá que descarguen GHA (si aún no está instalado) y se iniciará el flujo de configuración de vinculación de cuentas y asignación de habitaciones.

Implementa el descubrimiento de apps

Puedes habilitar la función App Discovery desde Google Home Developer Console después de completar el proceso de verificación de la marca. No se necesitan cambios en el código. Sin embargo, tu integración de Cloud-to-cloud ya debe estar revisada y en producción.

Accede a Developer Console:

Ve a Play Console

  1. Abre tu proyecto de integración de Cloud-to-cloud.

  2. Haz clic en Perfil de la empresa.

  3. Sigue los pasos que se indican en Cómo crear un perfil de empresa para conectar el sitio web de tu empresa a tu proyecto de integración.

Vínculo directo a Google Home

Los vínculos directos te permiten llevar a los usuarios directamente a un destino específico dentro de GHA desde tu app para Android o iOS, lo que simplifica el proceso de configuración del dispositivo con Assistant.

La sintaxis de los vínculos directos de GHA es la siguiente:

https://home.google.com/home-app/?deeplink=destination
GHA

Actualmente, tu app para Android o iOS puede vincularse a los siguientes destinos dentro de GHA:

Destino Descripción
setup/ha_linking?agent_id=agent-id Inicia el flujo de vinculación de cuentas de OAuth para el agent-id de la integración de Cloud-to-cloud determinada.

La ruta de destino debe estar codificada como URL de forma correcta antes de aplicarla al vínculo directo. Por ejemplo:

https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

Para obtener más detalles sobre cómo activar vínculos directos desde tu app, consulta la documentación de Android y la documentación de iOS relevantes.