Erreurs courantes

Cette page décrit les erreurs les plus fréquemment renvoyées par l'API Google Ad Manager. Les erreurs sont renvoyées au format Error.REASON :

Erreurs de limite d'entités

EntityChildrenLimitReachedError

Résumé
Le nombre maximal d'enfants autorisés a été atteint pour l'entité, et aucun autre enfant ne peut être ajouté à cette entité.
Conseils de résolution
Créez un type d'entité ayant atteint le nombre maximal d'enfants autorisé, puis ajoutez l'entité enfant que vous essayez de créer à la nouvelle entité. Par exemple, si vous recevez LINE_ITEM_LIMIT_FOR_ORDER_REACHED, vous devez créer un ordre et y ajouter l'élément de campagne que vous essayez de créer.

Erreurs de quota

QuotaError.EXCEEDED_QUOTA

Résumé
Le nombre de requêtes par seconde est trop élevé et a dépassé la limite autorisée.
Conseils de résolution
  • Utilisez des méthodes par lot telles que updateLineItems en regroupant les modifications localement et en effectuant une seule requête pour les appliquer toutes en même temps.
  • Attendez environ cinq secondes, puis relancez la requête. Notez que cela ne garantit pas que la requête aboutira. Si l'opération échoue à nouveau, essayez d'augmenter le temps d'attente. Cette option est recommandée pour les applications interactives s'intégrant à Ad Manager qui sont utilisées en temps réel.
  • Limitez les requêtes à deux par seconde pour les réseaux Ad Manager ou à huit par seconde pour les réseaux Ad Manager 360. Encore une fois, cela ne garantit pas que chaque requête aboutira, mais cela peut aider à réduire le nombre de fois où vous recevez cette erreur. Cette option est recommandée pour les applications qui s'intègrent à Ad Manager et qui n'ont pas d'interaction en temps réel, comme l'exécution de rapports nocturnes.

Erreurs d'authentification

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Résumé
L'utilisateur a essayé de créer un réseau de test à l'aide d'un compte déjà associé à un réseau.
Causes courantes
L'utilisateur n'a pas créé de compte Google avant d'appeler NetworkService.makeTestNetwork().
Conseils de résolution
Créez un compte avant d'appeler NetworkService.makeTestNetwork(). Pour en savoir plus, consultez Créer un réseau de test.

AuthenticationError.NETWORK_CODE_REQUIRED

Résumé
L'utilisateur n'a pas fourni de networkCode. Pour effectuer la requête, un code réseau est requis.
Causes courantes
Les codes réseau sont obligatoires pour toutes les requêtes, sauf NetworkService.getAllNetworks() et NetworkService.makeTestNetwork().
Conseils de résolution
Incluez le code du réseau concerné dans l'en-tête de la requête. Utilisez uniquement un code réseau disponible pour votre compte de connexion. Vous trouverez ce code sur le site Web Ad Manager de votre compte, sur la page "Admin" > "Paramètres réseau", à côté de "Code de réseau". Pour en savoir plus sur la définition de votre code réseau, consultez la page En-têtes de requête et de réponse SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Résumé
La requête n'a pas pu être effectuée, car le code réseau fourni dans la configuration est introuvable sur le serveur.
Causes courantes
Vous avez spécifié un code réseau incorrect dans votre configuration.
Conseils de résolution
Le champ "trigger" du journal d'erreurs suggère souvent le réseau approprié pour l'utilisateur.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Résumé
L'utilisateur n'est associé à aucun réseau.
Causes courantes
Vous n'avez pas activé l'accès API pour votre compte de production.
Conseils de résolution
Activez l'accès de l'API à votre environnement de production. Pour en savoir plus, consultez Activer l'accès à l'API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Résumé
Le client n'est pas autorisé à accéder à l'API.
Causes courantes
Votre réseau n'est pas autorisé pour la production, mais vous avez fourni un code réseau dans l'en-tête SOAP.
Conseils de résolution
Activez l'accès à l'API.

Erreurs liées aux autorisations

PermissionError.PERMISSION_DENIED

Résumé
L'utilisateur ne dispose pas de l'autorisation requise pour la requête.
Causes courantes
  • Vous avez essayé d'accéder à un objet qui existe dans un autre réseau.
  • Vous avez essayé d'accéder à un objet qui existe dans votre réseau, mais vous n'êtes pas autorisé à le lire ni à le modifier.
  • Vous avez tenté d'effectuer une tâche qui nécessite l'activation d'une fonctionnalité supplémentaire sur votre compte.
Conseils de résolution
  • Si vous créez une UI, indiquez à l'utilisateur qu'il n'est pas autorisé à effectuer cette action et qu'il doit contacter son administrateur.
  • Si vous avez essayé d'effectuer une tâche, par exemple une tâche impliquant une fonctionnalité premium que votre réseau n'est pas autorisé à utiliser, contactez votre responsable de compte pour activer cette fonctionnalité.
  • N'oubliez pas que les réseaux de test ne sont pas des réseaux Ad Manager 360 par défaut. Cela signifie qu'ils ne disposent pas des fonctionnalités premium des réseaux Ad Manager 360. Contactez votre responsable de compte pour activer des fonctionnalités sur votre réseau de test.

Erreurs de version

ApiVersionError.UPDATE_TO_NEWER_VERSION

Résumé
L'application a soit lancé une requête qui nécessite une version plus récente pour aboutir, soit lancé une requête vers une version obsolète.
Causes courantes
  • La version de l'appel d'API est obsolète. Veuillez vous abonner à notre blog pour recevoir les annonces d'abandon.
  • La requête que vous avez effectuée nécessite une version plus récente de l'API pour aboutir. C'est souvent le cas lorsqu'une fonctionnalité a été introduite dans l'interface utilisateur et que l'API a besoin d'une version plus récente pour envoyer l'objet correctement.
Conseils de résolution
  • Tenez-vous informé des versions d'API et prévoyez de les mettre à jour régulièrement.
  • Abonnez-vous à notre blog pour être informé des abandons.

Erreur 404

Résumé
Votre requête n'a pas atteint le serveur.
Causes courantes
Votre connexion Internet ou votre proxy sont peut-être mal configurés. La version de l'API que vous appelez peut également être abandonnée.
Conseils de résolution
Vérifiez votre configuration Internet ou de proxy, et assurez-vous d'utiliser une version récente de l'API. Vous pouvez également mettre à niveau votre bibliothèque cliente vers la version la plus récente.
Conseils de prévention
Consultez la communauté d'aide Ad Manager et notre blog pour vous tenir informé des dernières actualités concernant l'API Ad Manager.

Erreur de démarshaling

Résumé
Le code XML SOAP de votre requête n'est pas conforme à la spécification WSDL.
Causes courantes
La requête contient des champs ou des entités qui ne sont pas inclus dans la spécification WSDL, ou qui se trouvent dans un espace de noms incorrect.
Il existe une incompatibilité de type dans la requête (par exemple, un champ d'entier a une valeur de chaîne).
Conseils de résolution
Assurez-vous que votre requête est conforme à la spécification WSDL.
Utilisez une bibliothèque cliente pour générer un code SOAP valide, puis utilisez-le pour effectuer une comparaison. Toutes les bibliothèques clientes permettent de consigner les requêtes et les réponses SOAP.