Surveiller les erreurs d'association de comptes dans votre projet de la console Google

Google appelle vos points de terminaison OAuth2 lors du processus d'association des comptes. Ces appels peuvent échouer pour différentes raisons. Des informations détaillées sont consignées sur ces erreurs. Vous pouvez les surveiller sur la page Explorateur de journaux de votre projet Cloud Console.

Filtrer les erreurs d'association de comptes

Sur la page Explorateur de journaux, définissez les filtres de requête sur le code suivant et cliquez sur le bouton Run Query (Exécuter la requête) :

  • Ressource: sélectionnez Projet d'action Assistant Google si vous avez créé le projet via la Console Actions on Google. Sinon, sélectionnez l'option Projet Google.
  • Nom du journal: sélectionnez l'option Association de comptes Google.
  • Gravité : définissez sur error. Toutes les entrées d'association de compte sont classées comme des erreurs.

Vous pouvez également filtrer par date en mettant à jour la période en haut de la page de l'explorateur de journaux, comme illustré dans la capture d'écran suivante:

Figure 1 : Filtres de requête de l'explorateur de journaux

Pour en savoir plus sur l'utilisation de l'explorateur de journaux, consultez la documentation correspondante.

Contenu des données d'erreur

Les données d'erreur concernant l'association de comptes sont contenues dans la propriété jsonPayload de l'entrée d'erreur. Les données incluent les champs suivants:

  • @type (String): toujours défini sur type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): étape d'association à laquelle l'erreur s'est produite. Définissez l'une des valeurs suivantes :
    • ACCOUNT_LINKING_STEP_UNDEFINED: étape non définie.
    • AUTH_CODE_EXCHANGE : étape permettant d'échanger le code d'authentification contre un jeton d'accès ou d'actualisation.
    • REFRESH_ACCESS_TOKEN: étape permettant d'actualiser un jeton d'accès.
    • TOKEN_REVOCATION : étape permettant de révoquer un jeton.
    • USERINFO: étape permettant de récupérer les informations sur l'utilisateur avec un jeton d'accès.
    • ASSERTION : étape permettant de créer un lien par assertion.
  • response (String, optional): représente une réponse HTTP :
    • status : état de la réponse HTTP.
    • body : description et chaîne de l'erreur.
  • request (String, optional): représente une requête HTTP et contient les paramètres de requête HTTP suivants: méthode, corps, URI et en-têtes.

Les champs request et response sont facultatifs, car ils sont parfois séparés en deux entrées différentes dans la visionneuse de journaux.

Lorsque vous implémentez votre serveur OAuth d'association de comptes Google et le serveur OAuth d'association de comptes Google simplifié, vous devez utiliser des codes de réponse HTTP spécifiques pour différents États. Les valeurs renvoyées doivent correspondre à l'état correct indiqué dans la documentation.