Errori comuni

Questa pagina descrive gli errori riscontrati più di frequente restituiti dall'API Google Ad Manager. Gli errori vengono restituiti nel formato Error.REASON:

Errori relativi ai limiti di entità

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.

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 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.

Errori di autenticazione

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.

Errori di autorizzazione

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.

Errori di versione

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.