Vinculación directa

La 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, puedes ayudar a los usuarios a incorporarse con mayor rapidez y reducir la frustración que genera la configuración.

La vinculación directa 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. Cuando los usuarios hacen clic en el vínculo, se les solicita que descarguen la GHA (si aún no la instalaron) y se inicia el flujo de configuración de vinculación de cuentas y asignación de salas.

Vínculo directo a Google Home

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

Para iniciar la vinculación de cuentas directamente en GHA, usa el siguiente vínculo universal:

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

En el ejemplo anterior, agent-id es el ID del proyecto de tu integración de cloud-to-cloud, que puedes encontrar en la Google Home Developer Console en la configuración del proyecto.

Para las aplicaciones para dispositivos móviles que se inician con un esquema personalizado (Android y iOS), también puedes usar lo siguiente:

googlehome://setup/ha_linking?agent_id=agent-id

Cuando los usuarios hacen clic en el vínculo universal, la plataforma para dispositivos móviles verifica la presencia del GHA y abre el flujo de vinculación de cuentas. Si la GHA no está instalada en el dispositivo del usuario, proporciona un manejo de resguardo para dirigir al usuario a instalar o actualizar la app desde Google Play o la tienda de aplicaciones de Apple.

Intent explícito de Android

Para activar el flujo de vinculación de cuentas directamente desde tu aplicación para Android con un intent explícito, haz lo siguiente:

val intent = Intent(Intent.ACTION_VIEW).apply {
    val agentId = "YOUR_AGENT_ID"
    data = Uri.parse("googlehome://setup/ha_linking?agent_id=$agentId")
    setPackage("com.google.android.apps.chromecast.app")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Fallback: open Google Play app, with web browser safety
    try {
        val playStoreIntent = Intent(Intent.ACTION_VIEW,
            Uri.parse("market://details?id=com.google.android.apps.chromecast.app"))
        startActivity(playStoreIntent)
    } catch (e: ActivityNotFoundException) {
        val playStoreUrl =
            "https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app"
        val webIntent = Intent(Intent.ACTION_VIEW, Uri.parse(playStoreUrl))
        startActivity(webIntent)
    }
}

Las URLs de vínculos directos heredadas con formato madeby.google.com o assistant.google.com dejaron de estar disponibles:

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

Actualiza todos los botones de la app y los sitios web de productos para usar el vínculo universal o el esquema personalizado googlehome://setup/ha_linking.

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 correspondientes.