Descubrimiento de apps y vínculos directos

La Google Home app (GHA) es la forma principal en que los usuarios conectan dispositivos inteligentes Google Assistant y asígnalos a estructuras y salas en Google Home Graph Para realizar la configuración, los usuarios suelen hacer clic en varias pantallas para encontrar tu smart home Acción de 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 La plataforma smart home de Google ofrece varias funciones prácticas que facilitan a los usuarios ingresar rápidamente al flujo de configuración y comenzar a usar su dispositivo smart home. Estas funciones se pueden integrar fácilmente en tu smart home Acciones con poco o ningún esfuerzo de programación.

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

  • App Discovery: Esta función habilita los usuarios verán chips de sugerencias para vincular a tu Acción en la GHA; haciendo clic en el chip, pueden conectar su smart home de dispositivos a Assistant en uso las cuentas de sus proveedores externos.
  • Vínculos directos: Esta función te permite incorporar un vínculo directo en en el sitio web de su aplicación o producto para que los usuarios conecten fácilmente 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 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 Actions on Google Console después de completar el proceso de verificación de la marca. No se requieren cambios en el código. Sin embargo, tu acción de smart home ya debe estar revisada y en producción.

Accede a Actions Console:

Ve a la consola de Actions on Google.

  1. Abre tu proyecto de smart home Actions.
  2. Haz clic en Implementar > Verificación de marca.
  3. Sigue estos pasos para conectar el sitio web de tu empresa a tu proyecto de Acciones.
    1. En el panel Sitios web, haz clic en Conectar sitio.
    2. Ingresa la URL del sitio web que quieres conectar y haz clic en Conectar. Google envía un correo electrónico al propietario del sitio web para confirmarlo. asociación.
  4. En el panel Android apps, haz clic en el botón Connect app y, luego, sigue las instrucciones que se muestran.

  5. En el mismo panel, activa la opción Habilitar el descubrimiento de apps para tu app conectada. Esta opción estará inhabilitada hasta que tu Acción haya revisarse y aprobarse.

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 GHA es la siguiente:

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

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

Destino Descripción
setup/ha_linking?agent_id=agent-id Iniciar el Flujo de vinculación de cuentas de OAuth para smart home especificado Acción agent-id

La ruta de destino debe ser Con codificación de URL antes de aplicarlos 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.