Google effettua chiamate ai tuoi endpoint OAuth2 durante la procedura di collegamento dell'account. Queste chiamate possono non riuscire per diversi motivi. Per questi errori vengono registrate informazioni dettagliate che puoi monitorare nella pagina Esplora log del progetto della console cloud.
Filtrare per 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 di azioni dell'Assistente Google se hai creato il progetto tramite la console di Actions on Google; in caso contrario, seleziona l'opzione Progetto Google.
- Nome log: seleziona l'opzione di errore Collegamento dell'Account Google.
- Gravità: imposta su error. Tutte le voci di collegamento degli account vengono classificate come errori.
Puoi anche filtrare per data aggiornando l'intervallo di tempo nella parte superiore della pagina Esplora log, come mostrato nello screenshot seguente:
Figura 1. Filtri delle query di Esplora log
Puoi trovare ulteriori informazioni su come utilizzare Esplora log nella documentazione di Esplora log.
Contenuti dei dati di errore
I dati relativi agli errori di collegamento dell'account sono contenuti nella proprietà jsonPayload della voce di errore. I dati includono i seguenti campi:
@type(String): impostato sempre sutype.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.step(String): il passaggio di collegamento in cui si è verificato l'errore. Imposta uno di questi valori:ACCOUNT_LINKING_STEP_UNDEFINED: un passaggio non definito.AUTH_CODE_EXCHANGE: il passaggio per scambiare il codice di autenticazione con il token di accesso o di aggiornamento.REFRESH_ACCESS_TOKEN: il passaggio per aggiornare un token di accesso.TOKEN_REVOCATION: il passaggio per revocare un token.USERINFO: il passaggio per recuperare le informazioni dell'utente con un token di accesso.ASSERTION: il passaggio per creare un collegamento per asserzione.
response(String, optional): rappresenta una risposta HTTP:status: lo stato della risposta HTTP.body: la descrizione e la stringa dell'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 dei log.
Quando implementi il server OAuth per il collegamento dell'Account Google e il server OAuth per il collegamento dell'Account Google semplificato, devi utilizzare codici di risposta HTTP specifici per stati diversi. I valori restituiti devono corrispondere allo stato corretto indicato nella documentazione.