Errori e avvisi

In questa pagina vengono descritti i diversi tipi di errori e avvisi che potresti riscontrare quando utilizzi l'API Display & Video 360.

Errori dell'API

Le richieste inviate all'API che non possono essere completate restituiscono un messaggio di errore. Le richieste che restituiscono errori vengono conteggiate ai fini della quota utente e vengono prese in considerazione durante l'esame delle richieste di quota aggiuntiva. Le risposte di errore devono essere elaborate e gestite per evitare errori futuri.

Una risposta di errore ha il formato seguente e include un codice di risposta HTTP, un messaggio di errore e uno stato Codice RPC di Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Di seguito è riportato un elenco di errori comuni dell'API, insieme alle azioni consigliate da intraprendere se vengono restituiti:

Nota: se l'errore persiste anche dopo aver eseguito l'azione consigliata, contatta l'assistenza per segnalare il problema.

Codice	RPC	Azione consigliata
400	INVALID_ARGUMENT	Si è verificato un problema con la tua richiesta. Esamina il campo del messaggio nella risposta di errore e modifica la richiesta di conseguenza.
401	UNAUTHENTICATED	La tua richiesta non è stata autenticata correttamente. Verifica di includere credenziali OAuth valide nella richiesta. Per ulteriori informazioni, consulta la nostra Guida introduttiva.
403	PERMISSION_DENIED	Non disponi delle autorizzazioni necessarie per completare la richiesta. Verifica che il tuo account utente disponga delle autorizzazioni appropriate per il partner o l'inserzionista pertinente.
404	NOT_FOUND	Impossibile trovare la risorsa che stai tentando di recuperare. Verifica che l'ID che stai utilizzando sia corretto e per il tipo di risorsa recuperato.
409	ABORTED	La risorsa che stai cercando di modificare è in fase di modifica altrove. Attendi qualche secondo e riprova a inviare la richiesta.
429	RESOURCE_EXHAUSTED	Hai superato il limite di frequenza o la quota di richieste giornaliera. Esamina l'utilizzo delle API utilizzando la console API di Google e modifica il flusso di lavoro in modo che operi nei limiti di quota esistenti. Per ulteriori informazioni, consulta la nostra pagina sull'ottimizzazione delle quote. Se le operazioni non possono essere completate entro la quota giornaliera specificata, puoi richiedere una quota aggiuntiva.
500	INTERNAL	Si è verificato un errore interno nell'API. Attendi qualche secondo e riprova. Se l'errore persiste, contatta l'assistenza.
504	DEADLINE_EXCEEDED	L'API ha impiegato troppo tempo per completare la richiesta. Attendi qualche secondo e riprova. Se l'errore persiste, contatta l'assistenza.

Errori SDF

L'API Display & Video 360 utilizza un metodo asincrono per generare e scaricare file di dati strutturati (SDF). Per questo motivo, gli errori generati durante la generazione dei file SDF vengono restituiti nell'attività di download dei file SDF completata. Un'attività di download di SDF che termina in error è contrassegnata come completata, ma ha un campo di errore compilato anziché un nome di risorsa multimediale nel campo response, come mostrato in questo esempio troncato:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Se ricevi un messaggio di errore strategico quando tenti di generare SDF, devi seguirlo di conseguenza. Se il messaggio di errore non è chiaramente utilizzabile, consigliamo di adottare le seguenti misure:

• Verifica che l'utente disponga delle autorizzazioni appropriate per le risorse del partner o dell'inserzionista principale.
• Verifica che gli ID forniti nel filtro siano accurati, che corrispondano al tipo di risorsa previsto e che rientrino nel contesto dell'ID principale specificato.
• Assicurati di non superare il limite di 20 attività di download simultanei di SDF per utente.

Se continui a riscontrare errori, contatta l'assistenza per segnalare il problema.

Avvisi che non bloccano la migrazione

Gli avvisi che non bloccano vengono assegnati agli elementi pubblicitari per indicare un problema che potrebbe influire sulla pubblicazione di un elemento pubblicitario. Avvisi simili vengono comunicati nell'interfaccia utente tramite un banner di notifica. Questi avvisi sono passivi e sono elencati nel campo warningMessages di un elemento pubblicitario.

Sebbene passivi, i problemi che causano questi avvisi possono influire sulla pubblicazione di un elemento pubblicitario al punto da impedirne del tutto l'esecuzione.

Prevenzione

Molti problemi che causano avvisi che non bloccano possono essere evitati mediante la corretta configurazione delle impostazioni degli elementi pubblicitari, tra cui:

• Periodo di pubblicazione: se il periodo di pubblicazione di un elemento pubblicitario non è valido o se il periodo di pubblicazione dell'ordine di inserzione principale è scaduto, l'elemento pubblicitario genererà un avviso e non verrà pubblicato. Per evitare quest'ultimo problema, assicurati che il periodo di pubblicazione di un elemento pubblicitario non termini dopo il periodo di pubblicazione del relativo ordine di inserzione principale.
• Creatività assegnate. Se non è stata assegnata alcuna creatività valida a un elemento pubblicitario, l'elemento pubblicitario genererà un avviso e non verrà pubblicato.
• Targeting: se il targeting di un elemento pubblicitario non è assegnato correttamente, l'elemento pubblicitario potrebbe generare un avviso e la pubblicazione potrebbe essere compromessa o bloccata del tutto.

Se stai replicando le configurazioni da un elemento pubblicitario esistente, assicurati che l'elemento pubblicitario esistente non generi avvisi inaspettati.

Monitoraggio

Potrebbero verificarsi problemi che causano avvisi che non bloccano la pubblicazione di un elemento pubblicitario. Per assicurarti che gli elementi pubblicitari vengano pubblicati correttamente, monitora gli elementi pubblicitari attivi per verificare la presenza di avvisi di nuova generazione. Gli elementi pubblicitari possono essere recuperati in blocco utilizzando la funzione advertisers.lineItems.list. Se un elemento pubblicitario genera un avviso imprevisto, devi risolvere il problema immediatamente per ridurre l'impatto sulla pubblicazione.

Possono sorgere problemi anche se le impostazioni o il targeting di un elemento pubblicitario non sono cambiati. Alcuni esempi sono la messa in pausa o la scadenza dell'ordine di inserzione principale e il ritiro degli elenchi di utenti o di altri tipi di targeting.