Deep-Links

Die Google Home app (GHA) ist die primäre Möglichkeit für Nutzer, Smart-Home-Geräte mit Google Assistant zu verbinden und sie Strukturen und Räumen in Google Home Graph zuzuweisen. Für die Einrichtung müssen Nutzer in der Regel mehrere Bildschirme durchlaufen, um Ihre Cloud-to-cloud Integration in einer Liste der verfügbaren Optionen zu finden. Wenn Sie es Nutzern erleichtern, den Einrichtungsprozess zu starten, können Sie sie schneller einbinden und die Frustration bei der Einrichtung verringern.

Mit Deeplinks können Sie einen Deeplink in Ihre 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 sie noch nicht installiert ist). Anschließend wird der Einrichtungsprozess für die Kontoverknüpfung und die Raumzuweisung gestartet.

Deeplink zu Google Home

Mit Deeplinks können Sie Nutzer von Ihrer Android oder iOS-App direkt zu einem bestimmten Ziel in der GHA weiterleiten und so die Geräteeinrichtung vereinfachen.

Verwenden Sie den folgenden universellen Link, um die Kontoverknüpfung direkt in der GHA zu starten:

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

Dabei ist agent-id die Projekt-ID Ihrer Cloud-to-Cloud Integration. Sie finden sie in der Google Home Developer Console unter den Projekteinstellungen.

Für mobile Anwendungen, die mit einem benutzerdefinierten Schema gestartet werden (Android und iOS), 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 Prozess zur Kontoverknüpfung. Wenn die GHA nicht auf dem Gerät des Nutzers installiert ist, müssen Sie eine Fallback-Lösung anbieten, mit der der Nutzer die App über Google Play oder den Apple App Store installieren oder aktualisieren kann.

Expliziter Intent für Android

So starten Sie den Prozess zur Kontoverknüpfung direkt über Ihre Android-App mit einem expliziten Intent:

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

Legacy-Deeplink-URLs, die mit madeby.google.com oder assistant.google.com formatiert sind, sind veraltet:

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

Aktualisieren Sie alle In-App-Schaltflächen und Produktwebsites, damit sie den universellen Link oder das benutzerdefinierte Schema googlehome://setup/ha_linking verwenden.

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