Liens profonds

L'Google Home app (GHA) est le principal moyen pour les utilisateurs de connecter des appareils connectés à Google Assistant et de les attribuer à des structures et des pièces dans Google Home Graph. Pour effectuer la configuration, les utilisateurs cliquent généralement sur plusieurs écrans pour trouver votre Cloud-to-cloud intégration dans une liste d'options disponibles. En facilitant le processus de configuration, vous pouvez aider les utilisateurs à s'intégrer plus rapidement et à réduire leur frustration.

Les liens profonds vous permettent d'intégrer un lien profond dans votre application ou sur le site Web de votre produit pour que les utilisateurs puissent facilement connecter leur smart home appareil à Assistant. Lorsque les utilisateurs cliquent sur le lien, ils sont invités à télécharger l'application Google Home GHA (si elle n'est pas déjà installée). Le flux de configuration de l'association de compte et de l'attribution de pièce est alors lancé.

Lien profond vers Google Home

Les liens profonds vous permettent de rediriger les utilisateurs directement vers une destination spécifique dans le GHA à partir de votre Android ou application iOS, ce qui simplifie le processus de configuration de l'appareil.

Pour lancer l'association de compte directement dans l'GHA, utilisez le lien universel suivant :

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

Où agent-id correspond à l'ID du projet de votre intégration cloud-to-cloud, que vous trouverez dans la Google Home Developer Console sous les paramètres du projet.

Pour les applications mobiles lancées à l'aide d'un schéma personnalisé (Android et iOS), vous pouvez également utiliser :

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

Lorsque les utilisateurs cliquent sur le lien universel, la plate-forme mobile vérifie la présence de l'application Google HomeGHA et ouvre le flux d'association de compte. Si le GHA n'est pas installé sur l'appareil de l'utilisateur, prévoyez une gestion de secours pour rediriger l'utilisateur vers Google Play ou l'App Store d'Apple afin qu'il puisse installer ou mettre à jour l'application.

Intent explicite Android

Pour déclencher le flux d'association de compte directement depuis votre application Android à l'aide d'un intent explicite :

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)
    }
}

Les URL d'anciens liens profonds au format madeby.google.com ou assistant.google.com sont obsolètes :

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

Mettez à jour tous les boutons intégrés à l'application et les sites Web des produits pour qu'ils utilisent le lien universel ou le schéma personnalisé googlehome://setup/ha_linking.

Pour en savoir plus sur le déclenchement de liens profonds depuis votre application, consultez la documentation Android et iOS.