El 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 el inicio del proceso de configuración para los usuarios, puedes ayudarlos a incorporarse más rápido y reducir su frustración.
La vinculación directa te permite incorporar un vínculo directo en tu app o en el sitio web del producto para que los usuarios puedan conectar fácilmente su dispositivo smart home a Assistant. Si hacen clic en el vínculo, se les pedirá a los usuarios que descarguen GHA (si aún no lo hicieron) y se iniciará el flujo de configuración de la vinculación de la cuenta y la asignación de la sala.
Vínculo directo a Google Home
Los vínculos directos te permiten llevar a los usuarios directamente a un destino específico dentro del 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://madeby.google.com/home-app/?deeplink=destination
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 la agent-id de la integración Cloud-to-cloud determinada.
|
La ruta de destino debe estar correctamente codificada como URL antes de que la apliques al vínculo directo. Por ejemplo:
https://madeby.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 pertinentes.