Erreurs courantes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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:
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.
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.
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.
-
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.
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.
-
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eThis page lists common Google Ad Manager API errors and offers troubleshooting tips.\u003c/p\u003e\n"],["\u003cp\u003eErrors are categorized by type, such as authentication, permission, and quota errors.\u003c/p\u003e\n"],["\u003cp\u003eEach error description includes a summary, common causes, and recommended handling tips.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to stay updated on API versions and subscribe to the Ad Manager API forum and blog for the latest news.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing client libraries for generating valid SOAP requests is recommended to avoid unmarshalling errors.\u003c/p\u003e\n"]]],[],null,["# Common Errors\n\nThis page describes the most frequently encountered errors returned by the\nGoogle Ad Manager API. Errors are returned in the format\n`Error.REASON`:\n\n- [`EntityChildrenLimitReachedError`](#EntityChildrenLimitReachedError)\n- [`QuotaError.EXCEEDED_QUOTA`](#QuotaError.EXCEEDED_QUOTA)\n- [`AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`](#AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK)\n- [`AuthenticationError.NETWORK_CODE_REQUIRED`](#AuthenticationError.NETWORK_CODE_REQUIRED)\n- [`AuthenticationError.NETWORK_NOT_FOUND`](#AuthenticationError.NETWORK_NOT_FOUND)\n- [`AuthenticationError.NO_NETWORKS_TO_ACCESS`](#AuthenticationError.NO_NETWORKS_TO_ACCESS)\n- [`AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`](#AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS)\n- [`PermissionError.PERMISSION_DENIED`](#PermissionError.PERMISSION_DENIED)\n- [`ApiVersionError.UPDATE_TO_NEWER_VERSION`](#ApiVersionError.UPDATE_TO_NEWER_VERSION)\n- [404 Error](#404Error)\n- [Unmarshalling Errors](#Unmarshalling)\n\n[Entity limit errors](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError)\n-------------------------------------------------------------------------------------------------------\n\n### `EntityChildrenLimitReachedError`\n\nSummary\n: The maximum number of allowed children has been reached for the entity\n and no more children can be added to that entity.\n\nRecommended handling tips\n: Create a new type of the entity that has reached the max allowed number\n of children and add the child entity you are trying to create to the new one.\n For example if you receive [LINE_ITEM_LIMIT_FOR_ORDER_REACHED](/ad-manager/api/reference/latest/LineItemService.EntityChildrenLimitReachedError.Reason#LINE_ITEM_LIMIT_FOR_ORDER_REACHED),\n then you will need to create a new order and add the line item you are trying\n to create to that new order.\n\n[Quota errors](/ad-manager/api/reference/latest/NetworkService.QuotaError)\n--------------------------------------------------------------------------\n\n### `QuotaError.EXCEEDED_QUOTA`\n\nSummary\n: The number of requests made per second is too high and has exceeded the\n allowable limit.\n\nRecommended handling tips\n:\n - Use batch methods such as [updateLineItems](/ad-manager/api/reference/latest/LineItemService#updateLineItems) by gathering changes locally and making a single request to fulfill those changes all at once.\n - Wait about 5 seconds and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time. This is recommended for interactive applications integrating with Ad Manager that are used in real time.\n - Limit requests to 2 per second for Ad Manager networks, or 8 per second for Ad Manager 360 networks. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error. This is recommended for applications integrating with Ad Manager that do not have real time interaction, such as running nightly reports.\n\n[Authentication errors](/ad-manager/api/reference/latest/NetworkService.AuthenticationError)\n--------------------------------------------------------------------------------------------\n\n### `AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK`\n\nSummary\n: The user tried to create a test network using an account that already is\n associated with a network.\n\nCommon causes\n: The user did not create a new Google account first before calling\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Create a brand new account before calling\n `NetworkService.makeTestNetwork()`. See [how to create a test network](/ad-manager/api/start#enable_api) for more\n information.\n\n### `AuthenticationError.NETWORK_CODE_REQUIRED`\n\nSummary\n: The user did not provide a `networkCode`. To make the request,\n a network code is required.\n\nCommon causes\n: Network codes are required for all requests except\n `NetworkService.getAllNetworks()` and\n `NetworkService.makeTestNetwork()`.\n\nRecommended handling tips\n: Include the network code of the network being addressed in the request\n header. Only use a network code available to your account login. You can find\n the code on the Ad Manager website for your account, on the Admin \\\u003e Network\n Settings page next to \"Network code\". More information about setting your\n network code can be found on the [SOAP XML request and\n response headers](/ad-manager/api/soap_xml) page.\n\n### `AuthenticationError.NETWORK_NOT_FOUND`\n\nSummary\n: The request could not be made because the network code provided in the\n configuration is not found on the server.\n\nCommon causes\n: You have specified an incorrect network code in your configuration.\n\nRecommended handling tips\n: The \"trigger\" field of the error log will often suggest the correct\n network for the user.\n\n### `AuthenticationError.NO_NETWORKS_TO_ACCESS`\n\nSummary\n: The user is not associated with any network.\n\nCommon causes\n: You have not enabled your production account for API access.\n\nRecommended handling tips\n: Enable API access to your production environment. See [Enabling API Access](/ad-manager/api/start#enable_api) for information.\n\n### `AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS`\n\nSummary\n: The customer is not whitelisted for API access.\n\nCommon causes\n: Your network is not whitelisted for production, but you provided a [network code](/ad-manager/api/soap_xml) in the SOAP Header.\n:\n\nRecommended handling tips\n: Enable [API access](/ad-manager/api/start#enable_api).\n:\n\n[Permission errors](/ad-manager/api/reference/latest/NetworkService.PermissionError)\n------------------------------------------------------------------------------------\n\n### `PermissionError.PERMISSION_DENIED`\n\nSummary\n: The user does not have the required permission for the request.\n\nCommon causes\n:\n - You tried to access an object that exists in another network.\n - You tried to access an object that exists in your network, but you don't have permission to read or update.\n - You tried to perform a task that requires an additional feature to enabled on your account.\n\nRecommended handling tips\n:\n - If you are creating a UI, indicate to the user that they did not have permission to perform this action and to speak to their Administrator.\n - If you tried performing a task, such as one involving a premium-only feature that your network does not have permission to do, speak to your account manager about enabling this feature.\n - Remember, test networks are, by default, not Ad Manager 360 networks, meaning that they do not have the premium features found in Ad Manager 360 networks. Speak to your account manager to enable features on your test network.\n\n[Version errors](/ad-manager/api/reference/latest/NetworkService.ApiVersionError)\n---------------------------------------------------------------------------------\n\n### `ApiVersionError.UPDATE_TO_NEWER_VERSION`\n\nSummary\n: The application either: initiated a request that requires a newer version\n to succeed; or initiated a request to a deprecated version.\n\nCommon causes\n:\n - The version of the API call has been deprecated. Please subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) for deprecation announcements.\n - The request you made requires a newer version of the API to succeed. This is often the case where a feature has been introduced in the UI and in order for the API to send the object correctly, it needs a newer version of the API.\n\nRecommended handling tips\n:\n - Stay up to date on API versions; plan on upgrading regularly.\n - Subscribe to our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api) to be notified about deprecations.\n\n404 Error\n---------\n\nSummary\n: Your request did not reach the server.\n\nCommon causes\n: Your internet connection or proxy may be misconfigured. The version of\n the API you are calling may also be sunsetted.\n:\n\nRecommended handling tips\n: Check your internet or proxy configuration and make sure you are using a\n recent version of the API. You may want to upgrade your client library to\n the most recent version as well.\n:\n\nPrevention tips\n: Subscribe to the [Ad\n Manager API forum](//groups.google.com/group/google-doubleclick-for-publishers-api) and check our [blog](//ads-developers.googleblog.com/search/label/ad_manager_api)\n to stay updated on the latest Ad Manager API news.\n\nUnmarshalling Error\n-------------------\n\nSummary\n: The SOAP XML in your request did not conform to the WSDL\n specification.\n\nCommon causes\n: The request contains fields or entities not included in the WSDL\n specification, or in the wrong namespace.\n:\n: There is a type mismatch in the request (e.g., an integer field has a\n string value).\n:\n\nRecommended handling tips\n: Ensure that your request conforms to the WSDL specification.\n:\n: Use a [client library](/ad-manager/api/clients) to generate\n valid SOAP, and use this for comparison. All client libraries support\n logging of SOAP requests and responses.\n:"]]
