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 Cloud-to-cloud integración en una lista de opciones disponibles. Si facilitas el proceso de configuración para los usuarios, puedes incorporarlos más rápido y reducir la frustración que sienten durante 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 puedan conectar fácilmente su smart home dispositivo a Assistant. Cuando los usuarios hacen clic en el vínculo, se les solicita que descarguen el GHA (si aún no está instalada) y se inicia el flujo de configuración de la vinculación de la cuenta y la asignación de la habitació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 Android o app para iOS, lo que simplifica el proceso de configuración del dispositivo.

Para iniciar la vinculación de la cuenta directamente en la 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 nube a nube , que puedes encontrar en la Google Home Developer Console en la configuración del proyecto.

En el caso de 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 de la GHA y abre el flujo de vinculación de la cuenta. Si el GHA no está instalado en el dispositivo del usuario, proporciona un control de resguardo para dirigir al usuario a instalar o actualizar la app desde Google Play o App Store de Apple.

Intent explícito de Android

Para activar el flujo de vinculación de la cuenta 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 heredados con el 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 integrados en 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 pertinente de Android y la documentación de iOS.