Errori più 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 manipolazione 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 manipolazione 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 e riprova. Tieni presente che questo non garantisce che la richiesta andrà a buon fine. 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 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. Ancora una volta, ciò non garantisce che ogni richiesta andrà 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 manipolazione 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, ad eccezione di NetworkService.getAllNetworks() e NetworkService.makeTestNetwork().
Suggerimenti per la manipolazione 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 manipolazione 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 manipolazione consigliati
Abilita l'accesso API al tuo ambiente di produzione. Per informazioni, vedi 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 manipolazione 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 manipolazione consigliati
  • Se stai creando un'interfaccia utente, indica all'utente che non dispone dell'autorizzazione per eseguire questa azione e di rivolgersi al suo 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, contatta il tuo account manager per attivare questa funzionalità.
  • Ricorda che le reti di test non sono reti Ad Manager 360 per impostazione predefinita, il che significa che non dispongono delle funzionalità premium presenti nelle reti Ad Manager 360. Contatta il tuo account manager per attivare le funzionalità nella 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 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 manipolazione 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 manipolazione 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 manipolazione 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.