Scegli il percorso di integrazione
Seleziona il percorso più adatto alle tue esigenze:
| Percorso | Ideale per | Scopri di più |
|---|---|---|
| Universal Commerce Protocol (UCP) | Commercianti e rivenditori. | Documenti UCP |
| Collegamento dell'account standard | Smart Home, TV e YouTube. | Documenti |
Il collegamento dell'account consente ai titolari di Account Google di connettersi ai tuoi servizi in modo rapido, semplice e sicuro. Puoi scegliere di implementare il collegamento dell'Account Google per condividere i dati di un utente dalla tua piattaforma con app e servizi Google.
Il protocollo OAuth 2.0 sicuro ti consente di collegare in modo sicuro l'Account Google di un utente al suo account sulla tua piattaforma, concedendo così alle applicazioni e ai dispositivi Google l'accesso ai tuoi servizi.
Gli utenti possono collegare o scollegare i propri account e, facoltativamente, creare un nuovo account sulla tua piattaforma con il collegamento dell'Account Google.
Casi d'uso
Ecco alcuni motivi per implementare il collegamento dell'Account Google:
Condividere i dati di un utente dalla tua piattaforma con app e servizi Google.
Eseguire l'integrazione con Google Shopping e le superfici AI (Ricerca, Gemini) utilizzando il Universal Commerce Protocol (UCP).
Riprodurre contenuti video e film utilizzando Google TV.
Gestire e controllare i dispositivi per la smart home collegati a Google utilizzando l'app Google Home e l'Assistente Google, "Ok Google, accendi le luci".
Creare esperienze e funzionalità personalizzate dell'Assistente Google per gli utenti con le azioni conversazionali, "Hey Google, ordina il mio solito da Starbucks".
Consentire agli utenti di guadagnare premi guardando live streaming idonei su YouTube dopo aver collegato il proprio Account Google a un account partner per i premi.
Precompilare i nuovi account durante la registrazione con i dati condivisi consensualmente da un profilo Account Google.
Funzionalità e requisiti
La seguente matrice definisce il supporto e i consigli per ogni flusso di collegamento.
| Flusso di collegamento | Funzionalità standard | Funzionalità UCP |
|---|---|---|
| App Flip | Consigliato | Consigliato |
| Collegamento semplificato | Consigliato | Consigliato |
| Collegamento OAuth | Obbligatorio (di riserva) | Obbligatorio (di riserva) |
| OAuth 2.1 | Consigliato | Consigliato |
Sviluppo agentico (MCP e UCP)
I modelli linguistici di grandi dimensioni (LLM) e gli agenti AI richiedono un'autenticazione efficace per accedere ai dati utente. Il collegamento dell'Account Google supporta questi paradigmi emergenti:
- Model Context Protocol (MCP): GAL funge da handshake di sicurezza. Gli agenti utilizzano i token OAuth 2.1 per eseguire query in modo sicuro sugli strumenti del server MCP.
Universal Commerce Protocol (UCP): consente agli agenti di shopping di accedere in modo sicuro a i profili utente e ai vettori di pagamento.
Migliora la privacy degli utenti definendo ambiti personalizzati per condividere solo i dati necessari e aumenta la fiducia degli utenti definendo chiaramente come vengono utilizzati i loro dati.
L'accesso ai dati e ai servizi ospitati sulla tua piattaforma può essere revocato scollegando gli account. L'implementazione di un endpoint di revoca dei token facoltativoti consente di rimanere sincronizzato con gli eventi avviati da Google, mentre la protezione cross-account (RISC) ti consente di notificare a Google eventuali eventi di scollegamento che si verificano sulla tua piattaforma.
Flussi di collegamento dell'account
Esistono tre flussi di collegamento dell'Account Google, tutti basati su OAuth e che richiedono la gestione o il controllo degli endpoint di autorizzazione e scambio di token conformi a OAuth 2.0.
Durante la procedura di collegamento, rilasci i token di accesso a Google per i singoli Account Google dopo aver ottenuto il consenso dei titolari degli account per collegare i propri account e condividere i dati.
Collegamento OAuth
Questo è il flusso di collegamento OAuth che invia gli utenti al tuo sito web per il collegamento. L'utente viene reindirizzato al tuo sito web per accedere al proprio account. Una volta eseguito l'accesso, l'utente acconsente a condividere i propri dati sul tuo servizio con Google. A questo punto, l'Account Google dell'utente e il tuo servizio sono collegati.
Il collegamento OAuth supporta i flussi OAuth del codice di autorizzazione e implicito. Il tuo servizio deve ospitare un endpoint di autorizzazione conforme a OAuth 2.0 per il flusso implicito e deve esporre sia un endpoint di autorizzazione sia un endpoint di scambio di token quando si utilizza il flusso del codice di autorizzazione.
Figura 1. Collegamento dell'account sullo smartphone di un utente con il collegamento OAuth
Collegamento App Flip basato su OAuth ("App Flip")
Un flusso OAuth che invia gli utenti alla tua app per il collegamento.
Il collegamento App Flip basato su OAuth guida gli utenti mentre si spostano tra le tue app mobile Android o iOS verificate e la piattaforma di Google per esaminare le modifiche proposte all'accesso ai dati e concedere il consenso a collegare il proprio account sulla tua piattaforma al proprio Account Google. Per attivare App Flip, il tuo servizio deve supportare il collegamento OAuth o il collegamento Accedi con Google basato su OAuth utilizzando il flusso del codice di autorizzazione.
App Flip è supportato sia per Android che per iOS.
Come funziona :
L'app Google verifica se la tua app è installata sul dispositivo dell'utente:
- Se l'app viene trovata, l'utente viene "trasferito" alla tua app. La tua app raccoglie il consenso dell'utente per collegare l'account a Google e poi "ritorna" alla superficie Google.
- Se l'app non viene trovata o si verifica un errore durante la procedura di collegamento App Flip, l'utente viene reindirizzato al flusso di collegamento semplificato o OAuth.
Figura 2. Collegamento dell'account sullo smartphone di un utente con App Flip
Collegamento semplificato basato su OAuth ("semplificato")
Il collegamento semplificato Accedi con Google basato su OAuth aggiunge Accedi con Google al collegamento OAuth, consentendo agli utenti di completare la procedura di collegamento senza uscire dalla superficie Google, riducendo così gli attriti e gli abbandoni.
Il collegamento semplificato basato su OAuth offre
la migliore esperienza utente con l'accesso, la creazione dell'account e il collegamento dell'account
senza interruzioni combinando Accedi con Google con il collegamento OAuth. Il tuo servizio deve supportare gli endpoint di autorizzazione e scambio di token conformi a OAuth 2.0.
Inoltre, l'endpoint di scambio di token deve supportare
le asserzioni JWT (JSON Web Token)
e implementare gli intenti check e get richiesti e,
facoltativamente, l'intento create.
Come funziona :
Google asserisce l'account utente e ti trasmette queste informazioni:
- Se esiste un account per l'utente nel tuo database, l'utente collega correttamente il proprio Account Google al proprio account sul tuo servizio.
- Se non esiste un account per l'utente nel tuo database e la creazione dell'account è supportata dal tuo servizio, l'utente può creare un nuovo account di terze parti con le informazioni asserite fornite da Google (indirizzo email, nome e immagine del profilo) oppure scegliere di accedere e collegare con un altro indirizzo email utilizzando il collegamento OAuth.
Figura 3. Collegamento dell'account sullo smartphone di un utente con il collegamento semplificato
Quale flusso dovresti utilizzare?
Ti consigliamo di implementare tutti i flussi per garantire agli utenti la migliore esperienza di collegamento. I flussi semplificati e App Flip riducono gli attriti di collegamento, in quanto gli utenti possono completare la procedura di collegamento in pochi passaggi. Il flusso di collegamento OAuth richiede il livello di impegno più basso ed è un buon punto di partenza, dopodiché puoi aggiungere gli altri flussi di collegamento.
Utilizzare i token
Il collegamento dell'Account Google si basa sui meccanismi standard dei token OAuth 2.0. Rilasci i token di accesso e i token di aggiornamento a Google dopo che l'utente ha acconsentito a collegare il proprio account.
- Token di accesso: token di breve durata utilizzati da Google per accedere alle tue API.
- Token di aggiornamento: token di lunga durata utilizzati da Google per ottenere nuovi token di accesso alla scadenza.
Per i contratti di protocollo dettagliati e i requisiti dei parametri, consulta l'articolo Endpoint di scambio di token.
Collegamento persistente
Il collegamento persistente è un requisito fondamentale per le integrazioni stabili. Garantisce che gli account utente rimangano collegati anche durante guasti di rete temporanei o aggiornamenti periodici delle credenziali.
Per implementare il collegamento persistente, utilizza un approccio a "finestra scorrevole": estendi la scadenza del token di aggiornamento esistente anziché ruotarlo (fai riferimento alla sezione 6 della RFC 6749). In questo modo si evitano condizioni di race e scollegamenti involontari che possono verificarsi se viene emesso un nuovo token di aggiornamento, ma non viene ricevuto o memorizzato correttamente da Google.
Registrarsi con Google
Avremo bisogno dei dettagli della tua configurazione OAuth 2.0 e di condividere le credenziali per attivare il collegamento dell'account. Per i dettagli, consulta la sezione relativa alla registrazione.