Le azioni di conversazione verranno ritirate il 13 giugno 2023. Per ulteriori informazioni, vedi la sezione Ritiro delle azioni conversazionali.

Collegamento dell'account

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Puoi utilizzare il collegamento degli account per collegare gli Account Google degli utenti con gli account utente nel tuo sistema di autenticazione. In questo modo puoi creare esperienze più complete per i tuoi utenti, ad esempio puoi salvare le preferenze relative a cibo o musica dell'utente, la cronologia delle transazioni e altre informazioni che puoi utilizzare per offrire un'esperienza più personalizzata.

Se l'Azione è un'app complementare delle app esistenti su diverse piattaforme (ad esempio, il Web o Android), puoi utilizzare il collegamento dell'account per rendere disponibili in modo sicuro le preferenze degli utenti su tutte le piattaforme, in modo da garantire un'esperienza multipiattaforma coerente.

Il collegamento dell'account per Actions on Google utilizza Accedi con Google, il sistema di autenticazione sicuro di Google e, facoltativamente, OAuth 2.0, il protocollo standard di settore per l'autorizzazione.

Comprendere il flusso di collegamento dell'account

Quando l'assistente associa un Account Google a un utente, puoi utilizzare il collegamento dell'account per richiedere l'autorizzazione dell'utente ad accedere all'Account Google in questione. Puoi utilizzare i dati dell'account per:

  • Per trovare una corrispondenza per l'account nel sistema di autenticazione, se l'utente ha già utilizzato la tua azione o una delle tue app su altre piattaforme.
  • Per creare un nuovo account nel sistema di autenticazione per un nuovo utente.

Actions on Google offre tre tipi di collegamento di account.

Accedi con Google

Figura 1: il tipo di collegamento dell'account Accedi con Google è la soluzione consigliata per le Azioni che hanno come target solo l'assistente.

Con Accedi con Google per l'assistente, l'azione può richiedere l'accesso al profilo Google dell'utente durante una conversazione, inclusi nome, indirizzo email e immagine del profilo. L'utente può completare l'intero flusso vocale, fornendo un'esperienza di accesso senza problemi.

Si consiglia questo tipo di collegamento dell'account se si applica uno dei seguenti casi:

  • Non disponi di un sistema di autenticazione esistente.
  • Hai già un sistema di autenticazione e vuoi collegarti solo agli utenti che si sono registrati alle tue app esistenti utilizzando il loro indirizzo @gmail.com.

Per scoprire di più, consulta la guida ai concetti di Accedi con Google e la guida all'implementazione.

Collegamento "Semplificato" per l'accesso con Google in OAuth

Figura 2: il collegamento semplificato è la soluzione consigliata per le azioni multipiattaforma.

Il tipo di collegamento "Semplificato" di Accedi con Google basato su OAuth aggiunge Accedi con Google oltre al collegamento dell'account basato su OAuth. In questo modo fornisci agli utenti Google un collegamento vocale semplificato e al contempo per gli utenti che si sono registrati al servizio tramite un'identità non Google.

Per utilizzare questo flusso, devi estendere uno dei flussi OAuth 2.0 standard supportati per aggiungere il supporto per le estensioni proprietarie di Google del protocollo, che ti consentono di:

  • Collega gli account senza problemi utilizzando le informazioni del profilo Google.
  • (Facoltativo) Crea facilmente nuovi account utilizzando le informazioni del profilo Google.

Questo tipo di collegamento degli account è consigliato se hai un sistema di autenticazione esistente e vuoi consentire agli utenti di connettersi a indirizzi non @gmail.com.

Per scoprire di più, consulta la guida ai concetti di collegamento "Semplificato" di Accedi con Google basata su OAuth e la guida all'implementazione.

Collegamento OAuth

Il tipo di collegamento OAuth supporta due flussi OAuth 2.0 standard di settore, implicito e di autorizzazione.

È sconsigliato utilizzare questo flusso perché richiede il trasferimento dell'interazione dell'utente dalla voce allo schermo. Puoi prendere in considerazione questo flusso se hai un'implementazione esistente di un server OAuth 2.0 e non puoi estendere l'endpoint di scambio di token per aggiungere il supporto per i protocolli di Google per il collegamento automatico e la creazione dell'account da un token ID.

Per scoprire di più, consulta la guida ai concetti di collegamento di OAuth e la guida all'implementazione.

Per ulteriori informazioni sull'implementazione del collegamento dell'account nella tua azione, consulta la seguente risorsa: