Errori comuni

Questa pagina descrive gli errori restituiti più frequentemente 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 cercando 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 cercando 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 a livello locale ed effettuando un'unica richiesta per implementarle tutte contemporaneamente.
  • Attendi circa 5 secondi, poi riprova. Tieni presente che questo non garantisce l'esito positivo della richiesta. Se l'operazione non va a buon fine, prova ad aumentare il tempo di attesa. Questo approccio è consigliato per le applicazioni interattive che si integrano con Ad Manager e che 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 può 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 prevedono interazioni 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 ulteriori informazioni, 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 di rete della rete a cui si fa riferimento 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 di richiesta e risposta SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Riepilogo
Non è stato possibile 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 emittente.
Cause comuni
Non hai abilitato l'accesso API per il tuo account di produzione.
Suggerimenti per la gestione consigliati
Attiva l'accesso API al tuo ambiente di produzione. Per informazioni, consulta la sezione Attivare l'accesso API.

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Riepilogo
Il cliente non è autorizzato per l'accesso 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 tentato di accedere a un oggetto presente in un'altra rete.
  • Hai tentato di accedere a un oggetto esistente nella tua rete, ma non disponi dell'autorizzazione per leggere o aggiornare.
  • 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 un'interfaccia utente, 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 le reti di test non sono, per impostazione predefinita, reti Ad Manager 360, il che significa che non dispongono delle funzionalità premium presenti nelle reti Ad Manager 360. Contatta il 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 essere completata; oppure ha avviato una richiesta a una versione ritirata.
Cause comuni
  • La versione della chiamata API è stata ritirata. Iscriviti al nostro blog per ricevere gli annunci relativi al ritiro.
  • La richiesta che hai effettuato richiede una versione più recente dell'API per essere completata. Ciò accade spesso quando una funzionalità è stata introdotta nell'interfaccia utente e, affinché l'API invii correttamente l'oggetto, è necessaria una versione più recente dell'API.
Suggerimenti per la gestione consigliati
  • Tieniti aggiornato sulle versioni dell'API e pianifica gli 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 essere configurati in modo errato. Potrebbe essere ritirata anche la versione dell'API che stai chiamando.
Suggerimenti per la gestione consigliati
Controlla la configurazione di internet o del proxy e assicurati di utilizzare una versione recente dell'API. Ti consigliamo di eseguire l'upgrade della libreria client anche alla versione più recente.
Suggerimenti per la prevenzione
Consulta la community di assistenza Ad Manager e il nostro blog per rimanere aggiornato sulle ultime novità dell'API Ad Manager.

Errore di unmarshalling

Riepilogo
L'XML SOAP nella tua richiesta non era conforme alla specifica WSDL.
Cause comuni
La richiesta contiene campi o entità non inclusi nella specifica WSDL o nello spazio dei nomi errato.
Nella richiesta è presente un mancato abbinamento dei tipi (ad es. un campo intero ha un valore stringa).
Suggerimenti per la gestione consigliati
Assicurati che la tua richiesta sia conforme alla specifica WSDL.
Utilizza una libreria client per generare SOAP valido e utilizzalo per il confronto. Tutte le librerie client supportano la registrazione delle richieste e delle risposte SOAP.