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'app GHA (se non è già installata) e viene avviato il flusso di configurazione per il collegamento dell'account e l'assegnazione della stanza.

Link diretto a Google Home

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

Di seguito è riportata la sintassi dei link diretti GHA:

https://madeby.google.com/home-app/?deeplink=destination

Al momento, la tua app Android o iOS può rimandare alle seguenti destinazioni all'interno dell'app GHA:

Destinazione Descrizione
setup/ha_linking?agent_id=agent-id Avvia il flusso di collegamento dell'account OAuth per l'Cloud-to-cloud agent-id dell'integrazione specificata.

Il percorso della destinazione deve essere codificato correttamente come URL prima di essere applicato al link diretto. Ad esempio:

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

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