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 intégration Cloud-to-cloud dans une liste d'options disponibles. En facilitant le démarrage du 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 appareil smart home à Assistant. En cliquant sur le lien, l'utilisateur est invité à télécharger l'GHA (si elle n'est pas déjà installée), et le flux de configuration de l'association de compte et de l'attribution de pièce est lancé.

Lien profond vers Google Home

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

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

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

Où agent-id est 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 GHA et ouvre le flux d'association de comptes. Si l'GHA n'est pas installée sur l'appareil de l'utilisateur, prévoyez une solution de remplacement pour rediriger l'utilisateur vers Google Play ou l'App Store d'Apple afin qu'il installe ou mette à jour l'application.

Intent explicite Android

Pour déclencher le flux d'association de comptes 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 anciennes URL de 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 de produits pour utiliser 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 correspondante.