Il existe de nombreux scénarios dans lesquels vous pouvez rencontrer des erreurs lorsque vous utilisez l'API Display & Video 360. Cela peut être dû à un bug dans votre code, à une saisie utilisateur non valide ou même à un problème avec l'API elle-même. Quelle que soit la raison, savoir résoudre les erreurs est une partie importante du processus de développement. Ce guide contient quelques bonnes pratiques pour vous aider à démarrer.
Vérification des principes de base
- Consultez le guide des conditions préalables. Assurez-vous d'avoir accès à Display & Video 360 et d'avoir un projet d'API correctement configuré.
- Si votre réponse contient des erreurs HTTP, veillez à les examiner attentivement et à vous assurer que la requête est envoyée à l'API et au service appropriés.
- Consultez le guide relatif aux autorisations. Assurez-vous que votre requête contient les identifiants OAuth 2.0 nécessaires.
Vérifiez que vous utilisez les bons identifiants. Pour savoir comment générer des identifiants d'authentification, consultez le guide Configurer votre application. Vous pouvez également transmettre votre jeton d'accès au point de terminaison tokeninfo de l'API Google OAuth2 pour vérifier qu'il est émis pour le bon projet d'API et autorisé pour le ou les champs d'application appropriés :
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN} 200 OK { "issued_to": "{API_PROJECT_CLIENT_ID}", "audience": "...", "scope": "{API_SCOPES}", "expires_in": ... }
Comprendre les erreurs
Lorsque l'API rencontre une erreur, elle renvoie normalement une réponse JSON contenant un objet error. Cet objet fournit du contexte supplémentaire sur l'erreur spécifique qui s'est produite.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
En règle générale, le contenu de l'objet error contient suffisamment d'informations pour vous aider à identifier le problème. Si ce n'est pas le cas, vous devrez peut-être effectuer des recherches supplémentaires pour comprendre ce que signifie l'erreur.
Recherche d'erreurs
Reportez-vous à la section sur les erreurs courantes, qui fournit des détails pour certaines des erreurs les plus fréquentes.
Si l'erreur n'est pas abordée dans la section sur les erreurs courantes, consultez la documentation de référence et essayez de rechercher le code d'erreur, l'état et le message.
Si vous rencontrez des erreurs qui ne sont pas documentées, veuillez nous en informer.
Identifier la cause racine
À ce stade, vous avez identifié l'erreur et compris ce qu'elle signifie. Si ce n'est pas le cas, revenez à la section Comprendre les erreurs ou obtenez de l'aide si vous pensez avoir rencontré une erreur dans l'API que vous ne pouvez pas corriger vous-même.
Avant de pouvoir corriger l'erreur, vous devez identifier sa cause. Il s'agit souvent d'un bug dans votre code ou d'une valeur saisie non valide.
Pour déterminer si le problème est lié à un bug dans votre code, vous devez d'abord vérifier que celui-ci fonctionne comme prévu. Dans un premier temps, pensez à examiner la section de code responsable de la requête qui a échoué afin de vérifier les problèmes évidents. Dans certains cas, il peut être nécessaire d'utiliser un outil de débogage pour parcourir le code ligne par ligne et s'assurer qu'il fonctionne correctement.
L'examen des requêtes HTTP est un autre moyen utile d'identifier les bugs potentiels, ainsi que les cas d'entrée non valide. De nombreuses bibliothèques clientes officielles peuvent être configurées pour consigner les requêtes et les réponses HTTP. Pour en savoir plus, consultez la documentation de la bibliothèque de votre choix. Vous pouvez également utiliser un proxy HTTP tel que Charles, Squid ou illique pour obtenir les journaux de requêtes et de réponses. Une fois que vous avez obtenu ces journaux, examinez-les pour vous assurer que les valeurs de paramètre de requête fournies par votre application sont correctes et correspondent à vos attentes.
Une fois que vous aurez identifié le bug ou l'entrée non valide à l'origine de l'erreur, nous espérons que le correctif sera évident. Toutefois, si vous ne parvenez pas à résoudre le problème ou si vous ne savez pas comment le résoudre, vous pouvez utiliser les informations que vous avez recueillies jusqu'à présent lorsque vous avez besoin d'aide.
Obtenir de l'aide
Si vous ne parvenez pas à résoudre l'erreur vous-même, vous pouvez contacter notre équipe d'assistance via ce formulaire du centre d'aide Display & Video 360.
Lorsque vous remplissez ce formulaire, veillez à inclure autant d'informations que possible sur le problème que vous rencontrez et les étapes de dépannage que vous avez déjà suivies. Informations utiles à inclure:
- Journaux de requêtes et de réponses HTTP Veillez à masquer les informations sensibles telles que les jetons d'accès OAuth 2.0, les adresses e-mail, etc.
- Extrait de code. Si vous êtes en mesure d'isoler le problème dans une section de code particulière ou si vous pensez qu'il est propre à une langue, incluez un petit extrait pour illustrer ce que vous faites.
- Informations supplémentaires, telles que la version et la plate-forme de l'environnement d'exécution/de l'interpréteur, qui peuvent être utiles pour d'autres personnes essayant de reproduire le problème
Résoudre le problème
Une fois que vous avez identifié la cause du problème et trouvé une solution, il est temps de mettre en œuvre un correctif. Dans la mesure du possible, testez votre correction dans un environnement contrôlé (par exemple, auprès d'un partenaire ou d'un annonceur configuré spécifiquement pour les tests) sur une série d'entrées bonnes et mauvaises avant de la déployer en production.