Erreurs courantes

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

Erreurs liées à la limite d'entités

EntityChildrenLimitReachedError

Résumé
Le nombre maximal d'enfants autorisés pour l'entité a été atteint. Vous ne pouvez plus en ajouter.
Conseils de résolution
Créez un type d'entité qui a atteint le nombre maximal d'enfants autorisé et ajoutez-y l'entité enfant que vous essayez de créer. Par exemple, si vous recevez le message LINE_ITEM_LIMIT_FOR_ORDER_REACHED, vous devrez créer une autre commande 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 effectuées par seconde est trop élevé et dépasse la limite autorisée.
Conseils de résolution
  • Utilisez des méthodes par lot telles que updateLineItems en rassemblant les modifications localement et en envoyant une seule requête pour les appliquer toutes en même temps.
  • Attendez environ cinq secondes, puis envoyez de nouveau la demande. Notez que cela ne garantit pas que la demande aboutira. Si l'opération échoue à nouveau, essayez d'augmenter le temps d'attente. Cette méthode est recommandée pour les applications interactives qui s'intègrent à Ad Manager et qui sont utilisées en temps réel.
  • Limitez les demandes à 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ù cette erreur s'affiche. Cette méthode 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 quotidiens.

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 envoyer la demande, vous devez indiquer un code réseau.
Causes courantes
Les codes réseau
sont obligatoires pour toutes les requêtes, à l'exception de NetworkService.getAllNetworks() et NetworkService.makeTestNetwork().
Conseils de résolution
 Incluez le code réseau du réseau concerné dans l'en-tête de la requête. N'utilisez qu'un code réseau disponible pour la connexion à votre compte. Vous trouverez le 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 demande 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 des erreurs suggère souvent le bon réseau 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 à l'API pour votre compte de production.
Conseils de résolution
 Activez l'accès à l'API pour 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 ne figure pas sur la liste blanche 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 aux API.

Erreurs d'autorisation

PermissionError.PERMISSION_DENIED

Résumé
 L'utilisateur ne dispose pas de l'autorisation requise pour la demande.
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 dans votre compte.
Conseils de résolution
  • Si vous créez une interface utilisateur, 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é réservée aux comptes Premium pour laquelle votre réseau n'est pas autorisé, 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 disponibles dans les 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 lancé une requête qui nécessite une version plus récente pour aboutir ou a 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 envoyé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'UI 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 de l'API et prévoyez de les mettre à niveau régulièrement.
  • Abonnez-vous à notre blog pour être informé des abandons.

Erreur 404

Résumé
Votre demande n'a pas atteint le serveur.
Causes courantes
Il est possible que votre connexion Internet ou votre proxy soient 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. Nous vous recommandons également de 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ésérialisation

Résumé
Le code XML SOAP de votre demande n'était 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 le mauvais espace de noms.
La requête présente une incompatibilité de type (par exemple, un champ entier a une valeur de chaîne).
Conseils de résolution
Assurez-vous que votre demande est conforme à la spécification WSDL.
Utilisez une bibliothèque cliente pour générer un code SOAP valide et l'utiliser à des fins de comparaison. Toutes les bibliothèques clientes sont compatibles avec la journalisation des requêtes et des réponses SOAP.