Errori e avvisi

L'API Display & Video 360 può rispondere con una serie di errori e avvisi. Una soluzione API integra deve gestire questi errori.

Errori API

Le richieste all'API che non riescono a eseguire l'azione prevista restituiscono un errore. Le risposte di errore devono essere rilevate e gestite.

Una risposta di errore dell'API ha un codice di risposta HTTP, un messaggio di errore e uno stato Google RPC code. Il formato è il seguente:

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

Di seguito è riportato un elenco di errori comuni dell'API e delle azioni consigliate:

Codici di errore
`400`	`INVALID_ARGUMENT` Si è verificato un problema con la tua richiesta. Esamina il campo del messaggio nella risposta di errore e aggiorna la richiesta di conseguenza.
`401`	`UNAUTHENTICATED` Non è stato possibile autenticare correttamente la tua richiesta. Verifica di includere credenziali OAuth valide nella richiesta. Per saperne di più, consulta la nostra guida rapida.
`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 tentando 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. Utilizza la console Google Cloud per esaminare l'utilizzo delle API. Aggiorna il workflow in modo che venga eseguito entro i limiti di quota esistenti. Per saperne di più, consulta la nostra guida sull'ottimizzazione dell'utilizzo.
`500`	`INTERNAL` L'API ha riscontrato un errore interno. Attendi qualche secondo e riprova a inviare la richiesta. 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 a inviare la richiesta. Se l'errore persiste, contatta l'assistenza.

Errori SDF

L'API Display & Video 360 utilizza attività a lunga esecuzione per produrre file di dati strutturati (SDF). Gli errori durante la creazione dei file SDF vengono restituiti nel operation completato. Il campo error conterrà i dettagli. Vedi questo esempio troncato:

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

Se il messaggio di errore non è chiaro, ti consigliamo di:

Verifica che l'utente abbia almeno il ruolo utente Standard per il partner o l'inserzionista principale.
Verifica che gli ID forniti nel filtro siano corretti. Gli ID devono corrispondere al tipo di risorsa previsto e devono essere risorse secondarie dell'ID radice.
Assicurati che l'utente abbia meno di venti attività di download simultanee di SDF.

Se continui a visualizzare errori, contatta l'assistenza.

Avvisi non bloccanti

Gli avvisi non bloccanti indicano un problema che potrebbe influire sulla pubblicazione degli annunci di una voce di inventario. Avvisi simili vengono visualizzati nell'interfaccia utente. Questi avvisi sono passivi ed elencati nell'elemento pubblicitario.

La causa principale di un avviso può influire sulla pubblicazione di un elemento pubblicitario. In alcuni casi potrebbe impedire completamente la pubblicazione degli annunci.

Prevenzione

Alcuni avvisi non bloccanti sono causati dalla configurazione errata di un elemento pubblicitario:

Periodo di pubblicazione: un elemento pubblicitario non pubblica annunci se il suo periodo di pubblicazione non è valido o se il periodo di pubblicazione del relativo ordine di inserzione è scaduto. Assicurati che un elemento pubblicitario abbia un periodo di pubblicazione all'interno di quello del suo ordine di inserzione.
Creatività assegnate: un elemento pubblicitario non può essere pubblicato se non gli è assegnata una creatività valida.
Targeting: la pubblicazione di un annuncio di un elemento pubblicitario potrebbe essere influenzata o impedita se il targeting non è assegnato correttamente.

Assicurati che un elemento pubblicitario esistente non generi avvisi prima di utilizzare le relative configurazioni in un nuovo elemento pubblicitario.

Monitoraggio

Gli avvisi non bloccanti possono essere visualizzati durante la pubblicazione di un elemento pubblicitario. Monitora gli elementi pubblicitari attivi per rilevare nuovi avvisi e assicurarti che vengano pubblicati correttamente. Recupera gli elementi pubblicitari collettivamente con una richiesta list. Se un elemento pubblicitario restituisce un avviso imprevisto, risolvi il problema il prima possibile per ridurre l'impatto sulla pubblicazione.

Gli avvisi possono essere aggiunti anche se le impostazioni o il targeting non sono stati modificati. Ecco alcuni esempi:

L'ordine di inserzione è in pausa o scade.
Un elenco utenti o un'opzione di targeting è ritirato.