Cómo supervisar errores de vinculación de cuentas en tu proyecto de Google Console

Google realiza llamadas a tus extremos de OAuth2 durante el proceso de vinculación de cuentas. Estas llamadas pueden fallar por diferentes motivos. Se registra información detallada de estos errores y puedes supervisarlos en la página Explorador de registros de tu proyecto de Cloud Console.

Filtrado de errores de vinculación de cuentas

En la página Explorador de registros, configura los filtros de consulta de la siguiente manera y haz clic en el botón Ejecutar consulta:

  • Recurso: Selecciona Proyecto de acción del Asistente de Google si creaste el proyecto mediante Actions on Google Console; de lo contrario, selecciona la opción Proyecto de Google.
  • Nombre del registro: Seleccione la opción Error al vincular cuentas de Google.
  • Gravedad: Se define como error; todas las entradas de vinculación de cuentas se clasifican como errores.

También puedes filtrar por fecha si actualizas el intervalo de tiempo en la parte superior de la página Explorador de registros, como se muestra en la siguiente captura de pantalla:

Figura 1: Filtros de consulta del Explorador de registros

Puedes encontrar más información sobre cómo usar el Explorador de registros en la documentación del Explorador de registros.

Contenido de los datos del error

Los datos de errores de vinculación de cuentas se encuentran en la propiedad jsonPayload de la entrada de error. Los datos incluyen los siguientes campos:

  • @type (String): Siempre establecido en type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): Es el paso de vinculación en el que se produjo el error. Configúralo en uno de estos valores:
    • ACCOUNT_LINKING_STEP_UNDEFINED: un paso no definido.
    • AUTH_CODE_EXCHANGE: El paso para intercambiar código de autenticación por token de actualización o acceso.
    • REFRESH_ACCESS_TOKEN: el paso para actualizar un token de acceso
    • TOKEN_REVOCATION: El paso para revocar un token.
    • USERINFO: el paso para recuperar la información del usuario con un token de acceso
    • ASSERTION: El paso para crear un vínculo mediante aserción.
  • response (String, optional): Representa una respuesta HTTP:
    • status: Es el estado de la respuesta HTTP.
    • body: La descripción y la string del error
  • request (String, optional): Representa una solicitud HTTP y contiene los siguientes parámetros de la solicitud HTTP: método, cuerpo, URI y encabezados.

Los campos request y response son opcionales, ya que a veces se separan en 2 entradas diferentes en el visor de registros.

Cuando implementa su servidor de OAuth de vinculación de Cuentas de Google y el servidor de OAuth de vinculación de Cuentas de Google optimizado, debe usar códigos de respuesta HTTP específicos para diferentes estados. Los valores que muestres deben corresponder al estado correcto que aparece en la documentación.