Errori comuni
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive gli errori riscontrati più di frequente restituiti dall'API Google Ad Manager. Gli errori vengono restituiti nel formato
Error.REASON:
EntityChildrenLimitReachedError
- Riepilogo
- È stato raggiunto il numero massimo di elementi secondari consentiti per l'entità
e non è possibile aggiungere altri figli a questa entità.
- Suggerimenti per la gestione consigliati
- Crea un nuovo tipo di entità che ha raggiunto il numero massimo consentito
di elementi figlio e aggiungi l'entità secondaria che stai cercando di creare alla nuova entità.
Ad esempio, se ricevi LINE_ITEM_LIMIT_FOR_ORDER_REACHED, dovrai creare un nuovo ordine e aggiungere l'elemento pubblicitario che stai cercando di creare al nuovo ordine.
QuotaError.EXCEEDED_QUOTA
- Riepilogo
- Il numero di richieste effettuate al secondo è troppo elevato e ha superato il limite consentito.
- Suggerimenti per la gestione consigliati
-
- Utilizza metodi batch come updateLineItems raccogliendo le modifiche localmente ed effettuando una singola richiesta per soddisfarle tutte contemporaneamente.
- Attendi circa 5 secondi e riprova. Tieni presente che ciò non garantisce che la richiesta andrà a buon fine. Se il problema persiste, prova ad aumentare il tempo di attesa. Questa opzione è consigliata per le applicazioni interattive integrate con Ad Manager e utilizzate in tempo reale.
- Limita le richieste a 2 al secondo per le reti Ad Manager o a 8 al secondo per le reti Ad Manager 360. Ancora una volta, ciò non garantisce che tutte le richieste vadano a buon fine, ma potrebbe contribuire a ridurre il numero di volte in cui si riceve questo errore. Questa opzione è consigliata per le applicazioni che si integrano con Ad Manager
che non interagiscono in tempo reale, come l'esecuzione di report notturni.
AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK
- Riepilogo
- L'utente ha provato a creare una rete di test utilizzando un account già associato a una rete.
- Cause comuni
- L'utente non ha creato un nuovo Account Google prima di chiamare
NetworkService.makeTestNetwork().
- Suggerimenti per la gestione consigliati
- Crea un nuovo account prima di chiamare
NetworkService.makeTestNetwork(). Per ulteriori informazioni, scopri come creare una rete di test.
AuthenticationError.NETWORK_CODE_REQUIRED
- Riepilogo
- L'utente non ha fornito un
networkCode. Per effettuare la richiesta, è necessario un codice di rete.
- Cause comuni
- I codici di rete sono obbligatori per tutte le richieste, tranne
NetworkService.getAllNetworks() e
NetworkService.makeTestNetwork().
- Suggerimenti per la gestione consigliati
- Includi il codice di rete della rete da indirizzare nell'intestazione della richiesta. Utilizza solo un codice di rete disponibile per l'accesso al tuo account. Puoi trovare
il codice sul sito web di Ad Manager per il tuo account, nella pagina Amministratore > Impostazioni
di rete accanto a "Codice di rete". Per ulteriori informazioni sull'impostazione del codice di rete, consulta la pagina Intestazioni delle richieste e delle risposte XML SOAP.
AuthenticationError.NETWORK_NOT_FOUND
- Riepilogo
- Impossibile effettuare la richiesta perché il codice di rete fornito nella configurazione non è stato trovato sul server.
- Cause comuni
- Hai specificato un codice di rete errato nella configurazione.
- Suggerimenti per la gestione consigliati
- Il campo "trigger" del log degli errori spesso suggerirà la rete corretta per l'utente.
AuthenticationError.NO_NETWORKS_TO_ACCESS
- Riepilogo
- L'utente non è associato ad alcuna rete.
- Cause comuni
- Non hai abilitato l'accesso all'API per il tuo account di produzione.
- Suggerimenti per la gestione consigliati
- Attiva l'accesso API al tuo ambiente di produzione. Per ulteriori informazioni, vedi Abilitazione dell'accesso API.
AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS
- Riepilogo
- Il cliente non è autorizzato ad accedere all'API.
- Cause comuni
- La tua rete non è autorizzata per la produzione, ma hai fornito un codice di rete nell'intestazione SOAP.
-
- Suggerimenti per la gestione consigliati
- Abilita l'accesso API.
-
PermissionError.PERMISSION_DENIED
- Riepilogo
- L'utente non dispone dell'autorizzazione necessaria per la richiesta.
- Cause comuni
-
- Hai tentato di accedere a un oggetto che esiste in un'altra rete.
- Hai provato ad accedere a un oggetto esistente nella tua rete, ma non hai l'autorizzazione di lettura o aggiornamento.
- Hai provato a eseguire un'attività che richiede l'attivazione di una funzionalità aggiuntiva sul tuo account.
- Suggerimenti per la gestione consigliati
-
- Se stai creando una UI, indica all'utente che non dispone dell'autorizzazione per eseguire questa azione e di parlare con il suo amministratore.
- Se hai provato a eseguire un'attività, ad esempio una che prevedeva una funzionalità esclusivamente premium che la tua rete non è autorizzata a eseguire, contatta il tuo account manager per attivare questa funzionalità.
- Ricorda che, per impostazione predefinita, le reti di test non sono reti Ad Manager 360,
ovvero non dispongono delle funzionalità premium presenti nelle reti
Ad Manager 360. Rivolgiti al tuo account manager per attivare le funzionalità sulla
rete di test.
ApiVersionError.UPDATE_TO_NEWER_VERSION
- Riepilogo
- L'applicazione ha avviato una richiesta che richiede una versione più recente per avere esito positivo oppure ha avviato una richiesta per una versione deprecata.
- Cause comuni
-
- La versione della chiamata API è stata deprecata. Iscriviti al nostro blog per ricevere annunci relativi al ritiro.
- Per avere esito positivo la richiesta che hai effettuato richiede una versione più recente dell'API.
Questo si verifica spesso in cui una funzionalità è stata introdotta nella UI e, per inviare correttamente l'oggetto, l'API richiede una versione più recente dell'API.
- Suggerimenti per la gestione consigliati
-
- Ricevi aggiornamenti sulle versioni dell'API; prevedi di eseguire regolarmente l'upgrade.
- Iscriviti al nostro blog per ricevere notifiche sui ritiri.
Errore 404
- Riepilogo
- La tua richiesta non ha raggiunto il server.
- Cause comuni
- La connessione a internet o il proxy potrebbero non essere configurati correttamente. Anche la versione dell'API che stai chiamando potrebbe essere ritirata.
-
- Suggerimenti per la gestione consigliati
- Controlla la configurazione di internet o del proxy e assicurati di utilizzare una versione recente dell'API. Puoi anche eseguire l'upgrade della tua libreria client alla versione più recente.
-
- Suggerimenti per la prevenzione
- Iscriviti al forum delle API di Ad Manager e consulta il nostro blog per ricevere aggiornamenti sulle ultime novità relative all'API di Ad Manager.
Errore di rimozione del marshalling
- Riepilogo
- Il file XML SOAP della tua richiesta non è conforme alla specifica WSDL.
- Cause comuni
- La richiesta contiene campi o entità non inclusi nella specifica WSDL oppure nello spazio dei nomi errato.
-
- La richiesta presenta una mancata corrispondenza del tipo (ad esempio, un campo con numeri interi ha un
valore stringa).
-
- Suggerimenti per la gestione consigliati
- Assicurati che la richiesta sia conforme alla specifica WSDL.
-
- Utilizza una libreria client per generare un SOAP valido e utilizzala per il confronto. Tutte le librerie client supportano il logging di richieste e risposte SOAP.
-
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-21 UTC.
[null,null,["Ultimo aggiornamento 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:"]]
