Monitorar erros de vinculação de conta no projeto do Console do Google

O Google faz chamadas para seus endpoints OAuth2 durante o processo de vinculação de contas. Essas chamadas podem falhar por vários motivos. Informações detalhadas são registradas para esses erros, e você pode monitorá-los na página Análise de registros do seu projeto do console do Cloud.

Como filtrar erros de vinculação de conta

Na página da Análise de registros, defina os filtros de consulta da seguinte maneira e clique no botão Executar consulta:

  • Recurso: selecione Projeto de ação do Google Assistente se você criou o projeto pelo Console das ações no Google. Caso contrário, selecione a opção Projeto do Google.
  • Nome do registro: selecione a opção de erro Vinculação de Conta do Google.
  • Gravidade: definida como erro. Todas as entradas de vinculação de conta são categorizadas como erros.

Também é possível filtrar por data atualizando o período na parte de cima da página do Explorador de registros, conforme mostrado na captura de tela a seguir:

Figura 1. Filtros de consulta do Logs Explorer

Saiba mais sobre como usar a Análise de registros na documentação da Análise de registros.

Conteúdo dos dados de erro

Os dados de erro de vinculação da conta estão contidos na propriedade jsonPayload da entrada de erro. Os dados incluem os seguintes campos:

  • @type (String): sempre definido como type.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 por um token de acesso ou de 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: método, corpo, 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 contas do Google e o servidor OAuth de vinculação de contas do Google simplificada, é necessário usar códigos de resposta HTTP específicos para estados diferentes. Os valores retornados precisam corresponder ao estado correto listado na documentação.