Display e L'API Video 360 v2 verrà ritirata il 3 settembre 2024. Esegui la migrazione alla v3 prima di questa data per evitare l'interruzione del servizio.

Questa pagina è stata tradotta dall'API Cloud Translation.

Errori e avvisi

In questa pagina vengono descritti i diversi tipi di errori e avvisi che puoi durante l'utilizzo dello strumento Display & l'API Video 360.

Errori relativi all'API

Le richieste effettuate all'API che non possono essere completate restituiscono un messaggio di errore. Le richieste che restituiscono errori vengono conteggiate nella quota di utenti e verranno prese in da tenere in considerazione durante l'esame delle richieste per una quota aggiuntiva. Risposte di errore devono essere elaborati e gestiti per evitare errori futuri.

Una risposta di errore ha il seguente formato e include un codice di risposta HTTP. un messaggio di errore e lo stato di un codice RPC di Google:

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

Di seguito è riportato un elenco di errori comuni relativi all'API e le azioni consigliate da intraprendere. se vengono restituiti:

Codice	RPC	Azione consigliata
`400`	`INVALID_ARGUMENT`	Si è verificato un problema con la tua richiesta. Esamina il campo nella risposta di errore e modificare la tua richiesta di conseguenza.
`401`	`UNAUTHENTICATED`	Non è stato possibile autenticare correttamente la tua richiesta. Verificare di includere un OAuth valido credenziali nella tua richiesta. Per ulteriori informazioni su questo argomento, fai riferimento alle Guida introduttiva.
`403`	`PERMISSION_DENIED`	Non disponi delle autorizzazioni necessarie per completare l'operazione la tua richiesta. Verifica che il tuo account utente abbia le autorizzazioni appropriate per il partner inserzionista.
`404`	`NOT_FOUND`	La risorsa che stai tentando di recuperare non può essere trovati. Verifica che il documento di identità che utilizzi sia sia per il tipo di risorsa recuperato.
`409`	`ABORTED`	La risorsa che stai tentando di modificare è in corso modificati altrove. Attendi qualche secondo e poi riprova a eseguire la richiesta.
`429`	`RESOURCE_EXHAUSTED`	Hai superato il limite di frequenza o quota di richieste giornaliere. Esamina l'utilizzo dell'API tramite Console API di Google e modifica del flusso di lavoro per operare all'interno della quota esistente limiti. Per ulteriori informazioni, consulta la nostra pagina su Ottimizzazione della quota. Se le operazioni non possono essere completate specifica della quota giornaliera, puoi richiedere una quota aggiuntiva.
`500`	`INTERNAL`	Si è verificato un errore interno dell'API. Attendi secondi e riprova a eseguire la richiesta. Se l'errore persiste, contatta l'assistenza.
`504`	`DEADLINE_EXCEEDED`	L'API ha richiesto troppo tempo per completare la richiesta. Attendi qualche secondo e riprova a eseguire la richiesta. Se l'errore persiste, contatta l'assistenza.

Errori SDF

La scheda Display e L'API Video 360 utilizza un metodo asincrono per generare e scaricare file di dati strutturati (SDF). Per questo motivo, gli errori generati durante la generazione dell'SDF vengono restituiti nell'SDF completato attività di download. Il completamento di un'attività di download di SDF in error è contrassegnata come completata, ma presenta un campo di errore compilato anziché il nome di una 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 che ti consente di eseguire un'azione quando tenti di generare gli SDF, devono seguirlo di conseguenza. Se il messaggio di errore non è chiaramente risolvibile, consiglia le seguenti azioni:

Verifica che l'utente disponga delle autorizzazioni appropriate per il genitore partner o di inserzionisti.
Verifica che gli ID specificati nel filtro siano accurati, corrispondono al tipo di risorsa previsto e rientrano nel contesto un determinato ID root.
Assicurati di non superare il limite di venti download simultanei di SDF più attività per utente.

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

Avvisi che non bloccano la migrazione

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

Sebbene passivi, i problemi che causano questi avvisi possono influire sulla pubblicazione di un fino a impedirne del tutto la pubblicazione.

Prevenzione

Molti problemi che causano avvisi che non bloccano la visualizzazione possono essere evitati adottando misure appropriate configurazione delle impostazioni dell'elemento pubblicitario, tra cui:

Periodo di pubblicazione: se il periodo di pubblicazione di un elemento pubblicitario non è valido o se periodo di pubblicazione dell'ordine di inserzione principale è scaduto, l'elemento pubblicitario genererà avviso e non verrà pubblicata. Per evitare il secondo problema, assicurati che una riga il periodo di pubblicazione dell'elemento non termina oltre il periodo di pubblicazione dell'inserimento principale ordine.
Creatività assegnate: se non esiste una creatività valida. assegnati a un elemento pubblicitario, quest'ultimo genererà un avviso e vengono pubblicate.
Targeting: se il targeting di un elemento pubblicitario non è assegnato correttamente, l'elemento pubblicitario potrebbe generare un avviso e la pubblicazione potrebbe colpiti o impediti del tutto.

Se stai replicando configurazioni da un elemento pubblicitario esistente, assicurati che l'elemento pubblicitario esistente non genera avvisi imprevisti.

Monitoraggio

Potrebbero verificarsi problemi che causano avvisi che non bloccano la pubblicazione mentre è attivo un elemento pubblicitario durante il periodo di pubblicazione. Per assicurarti che gli elementi pubblicitari vengano pubblicati correttamente, monitora gli elementi pubblicitari attivi per gli avvisi appena generati. 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 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 includono la messa in pausa o la scadenza dell'ordine di inserzione principale e la il ritiro degli elenchi di utenti o di altri targeting.