Errori più comuni

In questa pagina vengono descritti gli errori più comuni restituiti dall'API Google Ad Manager. Gli errori vengono restituiti nel formato Error.REASON:

Errori relativi al limite di entità

EntityChildrenLimitReachedError

Riepilogo
È stato raggiunto il numero massimo di elementi secondari consentiti per l'entità e non è possibile aggiungerne altri.
Suggerimenti per la gestione consigliati
Crea un nuovo tipo di entità che ha raggiunto il numero massimo consentito di elementi secondari e aggiungi l'entità secondaria che stai tentando di creare a quella nuova. Ad esempio, se ricevi LINE_ITEM_LIMIT_FOR_ORDER_REACHED, dovrai creare un nuovo ordine e aggiungere l'elemento pubblicitario che stai tentando di creare a questo nuovo ordine.

Errori di quota

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 un'unica richiesta per applicarle tutte contemporaneamente.
  • Attendi circa 5 secondi, poi riprova. Tieni presente che questo non garantisce che la richiesta venga eseguita correttamente. Se l'operazione non va a buon fine, prova ad aumentare il tempo di attesa. Questa opzione è consigliata per le applicazioni interattive che si integrano con Ad Manager e vengono 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. Anche in questo caso, non è garantito che ogni richiesta vada a buon fine, ma potrebbe contribuire a ridurre il numero di volte in cui ricevi questo errore. Questa opzione è consigliata per le applicazioni che si integrano con Ad Manager che non hanno un'interazione in tempo reale, ad esempio l'esecuzione di report notturni.

Errori di autenticazione

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Riepilogo
L'utente ha tentato di 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 saperne di più, consulta 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, ad eccezione di NetworkService.getAllNetworks() e NetworkService.makeTestNetwork().
Suggerimenti per la gestione consigliati
Includi il codice della rete a cui è indirizzata la richiesta 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 saperne di più 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 suggerisce la rete corretta per l'utente.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Riepilogo
L'utente non è associato ad alcuna rete.
Cause comuni
Non hai attivato l'accesso API per il tuo account di produzione.
Suggerimenti per la gestione consigliati
Abilita l'accesso API al tuo ambiente di produzione. Per informazioni, consulta Abilitazione dell'accesso API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Riepilogo
Il cliente non è inserito nella lista consentita per l'accesso all'API.
Cause comuni
La tua rete non è inclusa nella lista consentita per la produzione, ma hai fornito un codice di rete nell'intestazione SOAP.
Suggerimenti per la gestione consigliati
Attiva l'accesso API.

Errori di autorizzazione

PermissionError.PERMISSION_DENIED

Riepilogo
L'utente non dispone dell'autorizzazione richiesta per la richiesta.
Cause comuni
  • Hai provato ad accedere a un oggetto che esiste in un'altra rete.
  • Hai provato ad accedere a un oggetto che esiste nella tua rete, ma non disponi dell'autorizzazione per leggerlo o aggiornarlo.
  • Hai provato a eseguire un'attività che richiede l'attivazione di una funzionalità aggiuntiva nel 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 rivolgersi all'amministratore.
  • Se hai provato a eseguire un'attività, ad esempio una che coinvolge una funzionalità solo premium che la tua rete non è autorizzata a eseguire, rivolgiti al tuo account manager per attivare questa funzionalità.
  • Ricorda che, per impostazione predefinita, le reti di test non sono reti Ad Manager 360, il che significa che non dispongono delle funzionalità premium presenti nelle reti Ad Manager 360. Rivolgiti al tuo account manager per attivare le funzionalità sulla tua rete di test.

Errori di versione

ApiVersionError.UPDATE_TO_NEWER_VERSION

Riepilogo
L'applicazione ha avviato una richiesta che richiede una versione più recente per andare a buon fine oppure ha avviato una richiesta a una versione deprecata.
Cause comuni
  • La versione della chiamata API è stata ritirata. Iscriviti al nostro blog per ricevere gli annunci relativi ai ritiri.
  • La richiesta che hai effettuato richiede una versione più recente dell'API per essere eseguita correttamente. Questo accade spesso quando una funzionalità è stata introdotta nella UI e, affinché l'API invii l'oggetto correttamente, è necessaria una versione più recente dell'API.
Suggerimenti per la gestione consigliati
  • Rimani aggiornato sulle versioni dell'API e pianifica l'upgrade regolarmente.
  • 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. Potresti anche voler eseguire l'upgrade della libreria client alla versione più recente.
Suggerimenti per la prevenzione
Consulta la community di assistenza di Ad Manager e il nostro blog per rimanere al corrente delle ultime novità sull'API Ad Manager.

Errore di unmarshalling

Riepilogo
Il codice XML SOAP nella richiesta non è conforme alla specifica WSDL.
Cause comuni
La richiesta contiene campi o entità non inclusi nella specifica WSDL o nello spazio dei nomi errato.
Esiste una mancata corrispondenza del tipo nella richiesta (ad esempio, un campo intero 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 utilizzalo per il confronto. Tutte le librerie client supportano il logging delle richieste e delle risposte SOAP.