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 a été atteint pour l'entité. Aucun autre enfant ne peut être ajouté à cette entité.
Conseils de traitement
Créez un type d'entité ayant atteint le nombre maximal d'enfants autorisé et ajoutez-y l'entité enfant que vous essayez de créer. Par exemple, si vous recevez LINE_ITEM_LIMIT_FOR_ORDER_REACHED, vous devez créer une campagne 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 a dépassé la limite autorisée.
Conseils de traitement
  • Utilisez des méthodes de traitement par lot telles que updateLineItems en recueillant les modifications localement et en effectuant une seule requête pour les traiter en une seule fois.
  • Patientez environ cinq secondes, puis relancez la requête. Notez que cela ne garantit pas que la requête aboutira. En cas d'échec à nouveau, essayez d'augmenter le temps d'attente. Cette option est recommandée pour les applications interactives en temps réel intégrant Ad Manager.
  • Limitez les requêtes à deux par seconde pour les réseaux Ad Manager ou à huit par seconde pour les réseaux Ad Manager 360. Là encore, cela ne garantit pas que chaque requête aboutira, mais peut aider à réduire le nombre de fois où vous recevez cette erreur. Cette opération est recommandée pour les applications intégrant Ad Manager qui n'interagissent pas 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 traitement
Créez un compte avant d'appeler NetworkService.makeTestNetwork(). Pour plus d'informations, consultez la section Créer un réseau de test.

AuthenticationError.NETWORK_CODE_REQUIRED

Résumé
L'utilisateur n'a pas fourni de networkCode. Pour envoyer la requête, vous devez indiquer un code de réseau.
Causes courantes
Les codes de réseau sont obligatoires pour toutes les requêtes, à l'exception de NetworkService.getAllNetworks() et NetworkService.makeTestNetwork().
Conseils de traitement
Incluez le code du réseau ciblé dans l'en-tête de la requête. N'utilisez qu'un code réseau permettant de vous connecter à votre compte. Vous le trouverez sur le site Web Ad Manager de votre compte, sur la page Administration > Paramètres des réseaux à côté de "Code de réseau". Pour en savoir plus sur la définition de votre code de réseau, consultez la page En-têtes de requête et de réponse XML SOAP.

AuthenticationError.NETWORK_NOT_FOUND

Résumé
Impossible d'envoyer la requête, car le code de réseau fourni dans la configuration est introuvable sur le serveur.
Causes courantes
Vous avez indiqué un code de réseau incorrect dans votre configuration.
Conseils de traitement
Le champ "Déclencheur" 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 aux API pour votre compte de production.
Conseils de traitement
Activez l'accès aux API pour votre environnement de production. Pour plus d'informations, consultez la section Activer l'accès aux API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Résumé
Le client ne figure pas sur la liste blanche d'accès à l'API.
Causes courantes
Votre réseau ne figure pas sur la liste blanche pour la production, mais vous avez fourni un code de réseau dans l'en-tête SOAP.
Conseils de traitement
Activez l'accès à l'API.

Erreurs d'autorisation

PermissionError.PERMISSION_DENIED

Résumé
L'utilisateur ne dispose pas de l'autorisation requise pour effectuer 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 ne disposez pas des autorisations nécessaires pour le lire ou le mettre à jour.
  • Vous avez essayé d'effectuer une tâche nécessitant l'activation d'une fonctionnalité supplémentaire dans votre compte.
Conseils de traitement
  • Si vous créez une UI, indiquez à l'utilisateur qu'il n'était pas autorisé à effectuer cette action ni à parler à son administrateur.
  • Si vous avez essayé d'effectuer une tâche impliquant une fonctionnalité premium uniquement pour laquelle votre réseau n'est pas autorisé à effectuer une tâche, contactez votre responsable de compte pour lui demander d'activer cette fonctionnalité.
  • N'oubliez pas que les réseaux de test ne sont pas des réseaux Ad Manager 360 par défaut. Ils ne disposent donc pas des fonctionnalités premium disponibles dans les réseaux Ad Manager 360. Contactez votre responsable de compte pour activer les fonctionnalités sur votre réseau test.

Erreurs de version

ApiVersionError.UPDATE_TO_NEWER_VERSION

Résumé
L'application a soit lancé une requête nécessitant une version plus récente pour réussir, soit lancé une requête vers une version obsolète.
Causes courantes
  • La version de l'appel d'API est obsolète. Abonnez-vous à notre blog pour être informé des abandons.
  • 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 pour que l'API envoie correctement l'objet, elle a besoin d'une version plus récente de l'API.
Conseils de traitement
  • Tenez-vous informé des versions de l'API et prévoyez de mettre à niveau régulièrement.
  • Abonnez-vous à notre blog pour être informé des abandons.

Erreur 404

Résumé
Votre demande n'est pas parvenue au serveur.
Causes courantes
Votre connexion Internet ou votre proxy est peut-être mal configuré. La version de l'API que vous appelez risque également d'être abandonnée.
Conseils de traitement
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
Abonnez-vous au forum sur l'API Ad Manager et consultez notre blog pour vous tenir informé des dernières actualités concernant l'API Ad Manager.

Erreur de démarshalling

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 non inclus dans la spécification WSDL, ou se trouvant dans un espace de noms incorrect.
Le type de la requête ne correspond pas (par exemple, un champ d'entier contient une valeur de chaîne).
Conseils de traitement
Assurez-vous que votre requête est conforme à la spécification WSDL.
Utilisez une bibliothèque cliente pour générer une demande SOAP valide, puis utilisez-la à des fins de comparaison. Toutes les bibliothèques clientes sont compatibles avec la journalisation des demandes et des réponses SOAP.