Deep-Links

Die Google Home app (GHA) ist die wichtigste Möglichkeit für Nutzer, Smart-Home-Geräte mit Google Assistant zu verbinden und sie Gebäuden und Räumen in Google Home Graph zuzuweisen. Für die Einrichtung klicken Nutzer in der Regel durch mehrere Bildschirme, um deine Cloud-to-cloud-Integration in einer Liste der verfügbaren Optionen zu finden. Wenn Sie Nutzern den Einstieg in die Einrichtung erleichtern, können Sie das Onboarding beschleunigen und die Frustration der Nutzer bei der Einrichtung verringern.

Mit Deeplinks kannst du einen Deeplink in deine App oder Produktwebsite einbetten, damit Nutzer ihr smart home-Gerät ganz einfach mit Assistant verbinden können. Wenn Nutzer auf den Link klicken, werden sie aufgefordert, die GHA herunterzuladen (falls noch nicht installiert). Anschließend wird der Einrichtungsablauf für die Kontoverknüpfung und Raumzuweisung gestartet.

Deeplink zu Google Home

Über Deeplinks kannst du Nutzer direkt zu einem bestimmten Ziel in der GHA aus deiner Android- oder iOS-App weiterleiten und so die Einrichtung des Geräts vereinfachen.

Wenn Sie die Kontoverknüpfung direkt in der GHA initiieren möchten, verwenden Sie den folgenden universellen Link:

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

Dabei ist agent-id die Projekt-ID deiner Cloud-to-Cloud-Integration, die du in der Google Home Developer Console unter den Projekteinstellungen findest.

Für mobile Apps, die mit einem benutzerdefinierten Schema (Android und iOS) gestartet werden, können Sie auch Folgendes verwenden:

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

Wenn Nutzer auf den universellen Link klicken, prüft die mobile Plattform, ob die GHA vorhanden ist, und öffnet den Kontoverknüpfungsprozess. Wenn die GHA nicht auf dem Gerät des Nutzers installiert ist, richte eine Fallback-Verarbeitung ein, um den Nutzer zur Installation oder Aktualisierung der App über Google Play oder den Apple App Store weiterzuleiten.

Expliziter Android-Intent

So lösen Sie den Kontoverknüpfungsvorgang direkt über Ihre Android-App mit einem expliziten Intent aus:

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

Ältere Deeplink-URLs, die mit madeby.google.com oder assistant.google.com formatiert sind, werden nicht mehr unterstützt:

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

Aktualisieren Sie alle In-App-Tasten und Produktwebsites, damit der universelle Link oder das benutzerdefinierte Schema googlehome://setup/ha_linking verwendet wird.

Weitere Informationen zum Auslösen von Deeplinks in Ihrer App finden Sie in der entsprechenden Android-Dokumentation und iOS-Dokumentation.