Link diretti

The Google Home app (GHA) è il modo principale in cui gli utenti collegano i dispositivi smart a Google Assistant e li assegnano a strutture e stanze in Google Home Graph. Per eseguire la configurazione, in genere gli utenti fanno clic su più schermate per trovare la tua Cloud-to-cloud integrazione in un elenco di opzioni disponibili. Se semplifichi l'avvio della procedura di configurazione per gli utenti, puoi aiutarli a eseguire l'onboarding più rapidamente e ridurre la frustrazione durante la configurazione.

I link diretti ti consentono di incorporare un link diretto nel sito web dell'app o del prodotto in modo che gli utenti possano collegare facilmente il proprio dispositivo smart home a Assistant. Quando gli utenti fanno clic sul link, viene chiesto loro di scaricare l'GHA (se non è già installata) e viene avviato il flusso di configurazione del collegamento dell'account e dell'assegnazione della stanza.

Link diretto a Google Home

I link diretti ti consentono di indirizzare gli utenti direttamente a una destinazione specifica all'interno GHA dalla tua Android o app iOS, semplificando la procedura di configurazione del dispositivo.

Per avviare il collegamento dell'account direttamente nell'app GHA, utilizza il seguente link universale:

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

Dove agent-id è l'ID progetto della tua integrazione da cloud a cloud, che puoi trovare in Google Home Developer Console in Impostazioni progetto.

Per le applicazioni mobile avviate utilizzando uno schema personalizzato (Android e iOS), puoi anche utilizzare:

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

Quando gli utenti fanno clic sul link universale, la piattaforma mobile verifica la presenza di GHA e apre il flusso di collegamento dell'account. Se il GHA non è installato sul dispositivo dell'utente, fornisci una gestione di fallback per indirizzare l'utente all'installazione o all'aggiornamento dell'app da Google Play o dall'App Store di Apple.

Intent esplicito di Android

Per attivare il flusso di collegamento dell'account direttamente dalla tua app per Android utilizzando un intent esplicito:

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

Gli URL dei link diretti legacy formattati con madeby.google.com o assistant.google.com sono ritirati:

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

Aggiorna tutti i pulsanti in-app e i siti web dei prodotti in modo che utilizzino il link universale o lo schema personalizzato googlehome://setup/ha_linking.

Per ulteriori dettagli sull'attivazione dei link diretti dall'interno dell'app, consulta la documentazione di Android e la documentazione di iOS pertinenti.