Google effettua chiamate ai tuoi endpoint OAuth2 durante la procedura di collegamento dell'account. Queste chiamate possono non riuscire per diversi motivi. Vengono registrate informazioni dettagliate per questi errori e puoi monitorarli nella pagina Esplora log del tuo progetto Cloud Console.
Filtrare in base agli errori di collegamento dell'account
Nella pagina Esplora log, imposta i filtri di query come segue e fai clic sul pulsante Esegui query:
- Risorsa: seleziona Progetto azioni Google Assistant se hai creato il progetto tramite Azioni su Google Console; in caso contrario, seleziona l'opzione Progetto Google.
- Nome log. Seleziona l'opzione di errore Collegamento dell'Account Google.
- Gravità: imposta il valore su error; tutte le voci di collegamento dell'account sono classificate come errori.
Puoi anche filtrare per data aggiornando l'intervallo di tempo nella parte superiore della pagina Esplora log, come mostrato nel seguente screenshot:
Figura 1. Filtri delle query di Esplora log
Per saperne di più su come utilizzare Esplora log, consulta la documentazione di Esplora log.
Contenuti dei dati di errore
I dati sugli errori di collegamento dell'account sono contenuti nella proprietà jsonPayload della voce di errore. I dati includono i seguenti campi:
@type(String): sempre impostato sutype.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.step(String): il passaggio del collegamento in cui si è verificato l'errore. Imposta uno di questi valori:ACCOUNT_LINKING_STEP_UNDEFINED: passaggio non definito.AUTH_CODE_EXCHANGE: il passaggio per scambiare il codice di autenticazione con un token di accesso o di aggiornamento.REFRESH_ACCESS_TOKEN: passaggio per aggiornare un token di accesso.TOKEN_REVOCATION: passaggio per la revoca di un token.USERINFO: il passaggio per recuperare le informazioni dell'utente con un token di accesso.ASSERTION: il passaggio necessario per creare un collegamento tramite asserzione.
response(String, optional): rappresenta una risposta HTTP:status: lo stato della risposta HTTP.body: descrizione dell'errore e stringa di errore.
request(String, optional): rappresenta una richiesta HTTP e contiene i seguenti parametri di richiesta HTTP: metodo, corpo, URI e intestazioni.
I campi request e response sono facoltativi perché a volte sono separati in due voci diverse nel visualizzatore log.
Quando implementi il server OAuth di collegamento dell'Account Google e il server OAuth di collegamento dell'Account Google semplificato, devi utilizzare codici di risposta HTTP specifici per i vari stati. I valori restituiti devono corrispondere allo stato corretto indicato nella documentazione.