O Google faz chamadas para seus endpoints do OAuth2 durante o processo de vinculação da conta. Essas chamadas podem falhar por diferentes motivos. As informações detalhadas são registradas para esses erros, e é possível monitorá-las na página Explorador de registros do projeto do Console do Cloud.
Como filtrar por erros de vinculação de contas
Na página Explorador de registros, defina os filtros de consulta da seguinte maneira e clique no botão Executar consulta:
- Recurso: selecione Google Assistant Project se você tiver criado o projeto no Actions on Google Console. Caso contrário, selecione a opção Google Project.
- Nome do registro: selecione a opção de erro Vinculação de Conta do Google.
- Gravidade: definida como error. Todas as entradas de vinculação de contas são categorizadas como erros.
Você também pode filtrar por data atualizando o período na parte superior da página do Explorador de registros, conforme mostrado na captura de tela a seguir:
Figura 1. Filtros de consulta do Explorador de registros
Veja mais informações sobre como usar o Explorador de registros na documentação dele.
Conteúdo dos dados de erro
Os dados de erros de vinculação de conta estão na propriedade jsonPayload da entrada de erro. Os dados incluem os seguintes campos:
@type(String): defina sempre comotype.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.step(String): a etapa de vinculação em que o erro ocorreu. Defina um destes valores:ACCOUNT_LINKING_STEP_UNDEFINED: uma etapa indefinida.AUTH_CODE_EXCHANGE: a etapa para trocar o código de autenticação pelo token de acesso ou atualização.REFRESH_ACCESS_TOKEN: a etapa para atualizar um token de acesso.TOKEN_REVOCATION: a etapa para revogar um token.USERINFO: a etapa para buscar informações do usuário com um token de acesso.ASSERTION: a etapa para criar um link por declaração.
response(String, optional): representa uma resposta HTTP:status: o status da resposta HTTP.body: a descrição e a string do erro.
request(String, optional): representa uma solicitação HTTP e contém os seguintes parâmetros de solicitação HTTP: method, body, URI e cabeçalhos.
Os campos request e response são opcionais porque às vezes são separados em duas entradas diferentes no visualizador de registros.
Ao implementar o servidor OAuth de vinculação de Conta do Google e o servidor OAuth de vinculação de Conta do Google simplificado, você precisa usar códigos de resposta HTTP específicos para estados diferentes. Os valores retornados precisam corresponder ao estado correto listado na documentação.