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 del Explorador de registros de tu proyecto de la consola de Cloud.
Filtrado de errores de vinculación de cuentas
En la página del Explorador de registros, establece los siguientes filtros de consulta y haz clic en el botón Ejecutar consulta:
- Recurso: Selecciona Google Assistant Action Project si creaste el proyecto a través de Actions on Google Console. De lo contrario, selecciona la opción Google Project.
- Nombre de registro: Selecciona la opción de error Vinculación de la Cuenta de Google.
- Gravedad: Configúralo como error. Todas las entradas de vinculación de cuentas se clasifican como errores.
También puedes filtrar por fecha actualizando el período en la parte superior de la página del 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 para usar el Explorador de registros en la documentación del Explorador de registros.
Contenido de los datos de 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 se establece comotype.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: Es el paso para intercambiar el código de autorización por un token de acceso o de actualización.REFRESH_ACCESS_TOKEN: Es el paso para actualizar un token de acceso.TOKEN_REVOCATION: Es el paso para revocar un token.USERINFO: Es el paso para recuperar la información del usuario con un token de acceso.ASSERTION: Es el paso para crear un vínculo por aserción.
response(String, optional): Representa una respuesta HTTP:status: Es el estado de la respuesta HTTP.body: La descripción y la cadena de error.
request(String, optional): Representa una solicitud HTTP y contiene los siguientes parámetros de solicitud HTTP: método, cuerpo, URI y encabezados.
Los campos request y response son opcionales porque, a veces, se separan en 2 entradas diferentes en el visor de registros.
Cuando implementes tu servidor de OAuth de vinculación de Cuentas de Google y el servidor de OAuth de vinculación de Cuentas de Google optimizado, deberás usar códigos de respuesta HTTP específicos para diferentes estados. Los valores que devuelves deben corresponder al estado correcto que se indica en la documentación.