Risoluzione dei problemi

Esistono molti scenari in cui si possono verificare errori durante l'utilizzo del Display e l'API Video 360. Potrebbero riguardare un bug nel tuo codice, un input utente non valido o addirittura un problema con l'API stessa. Qualunque sia la ragione, sapendo come la risoluzione degli errori è una parte importante del processo di sviluppo. Questa guida ti fornirà alcuni suggerimenti di best practice per iniziare.

Revisione delle nozioni di base

1. Consulta la guida ai prerequisiti. Assicurati di avere accesso a Display e Video 360 e un progetto API configurato correttamente.
2. Se la tua risposta contiene errori HTTP, assicurati di leggerli attentamente e assicurarti che la richiesta venga inviata all'API e al servizio corretti.
3. Consulta la guida all'autorizzazione. Assicurati che la richiesta contenga le credenziali OAuth 2.0 necessarie.

4. Verifica di utilizzare le credenziali corrette. Consulta le Guida alla configurazione dell'applicazione per maggiori dettagli sulla generazione credenziali di autenticazione. Puoi anche passare il tuo token di accesso Endpoint tokeninfo dell'API Google OAuth2 per verificare che sia sono stati inviati al progetto API corretto e autorizzati per gli ambiti corretti:

   POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}
   
   200 OK
   
   {
    "issued_to": "{API_PROJECT_CLIENT_ID}",
    "audience": "...",
    "scope": "{API_SCOPES}",
    "expires_in": ...
   }
   

Comprendere gli errori

Quando l'API rileva un errore, di solito restituisce una risposta JSON contenente un oggetto error. Questo oggetto fornisce contesto aggiuntivo sullo specifico che si è verificato.

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

Nota :se ricevi una risposta di errore che non include error è possibile che l'errore non provenga dall'oggetto Display & l'API Video 360. Non dimenticare di apporre prima di continuare, consulta la sezione dedicata alla revisione delle informazioni di base.

Di solito, i contenuti dell'oggetto error contengono informazioni sufficienti ti aiuteranno a identificare cosa è andato storto. In caso contrario, potresti dover eseguire altre ricerca per capire cosa significa l'errore.

Ricerca degli errori

1. Consulta la sezione sugli errori comuni, che fornisce per alcuni degli errori riscontrati più di frequente.

2. Se l'errore non è trattato nella sezione degli errori comuni, consulta le documentazione di riferimento e prova a cercare il codice di errore, lo stato e il messaggio.

3. Se riscontri errori non documentati, ti invitiamo a comunicarcelo.

di Gemini Advanced.

Punto chiave: se l'errore che hai riscontrato riguarda la convalida dei campi o una limite di partner/inserzionisti, consulta Display e Per saperne di più, consulta il Centro assistenza Video 360. Queste regole e i limiti vengono ereditati da Display & Video 360 e non vengono applicate in base al Display e dell'API Video 360.

Identificazione della causa principale

A questo punto hai identificato l'errore e capito il suo significato. In caso contrario, torna a Comprendere gli errori oppure passa direttamente al ricevere assistenza se ritieni di aver riscontrato un errore nell'API che non puoi risolvere da solo.

Prima di poter correggere l'errore, dovrai identificarne la causa. Spesso si tratta di un bug nel codice o di un valore di input non valido.

Per determinare se il problema è correlato a un bug nel tuo codice, verificare che il codice funzioni come previsto. Per prima cosa, valuta la possibilità di rivedere la sezione di codice responsabile dell'errore per verificare la presenza di problemi evidenti. In alcuni casi può essere necessario utilizzare un strumento di debug per esaminare il codice riga per riga e verificare che funzioni in modo corretto.

L'analisi delle richieste HTTP è un altro modo utile per identificare potenziali bug, così come i casi di input non validi. Molte delle librerie client ufficiali possono essere configurato per registrare richieste e risposte HTTP; consulta la documentazione libreria di tua scelta per ulteriori dettagli. Un proxy HTTP come Charles, Squid o Fiddler e i log delle richieste e delle risposte. Una volta ottenuti di log, esaminali per assicurarti che i valori dei parametri di richiesta forniti che la richiesta sia corretta e corrisponda a quanto previsto.

Dopo aver identificato il bug o l'input non valido responsabile dell'errore, si spera che la soluzione sia ovvia. Se sei bloccato o non sai come risolvere il problema problema, tuttavia, puoi utilizzare le informazioni raccolte finora per ricevere assistenza.

Richiesta di aiuto

Se non sei in grado di risolvere un errore autonomamente, puoi contattare l'assistenza tramite questo modulo disponibile nella sezione Centro assistenza Video 360.

Quando compili questo modulo, devi includere il maggior numero possibile di informazioni sul problema che stai riscontrando e sui passaggi per la risoluzione dei problemi già eseguiti prese. Informazioni utili da includere:

• Log delle richieste e delle risposte HTTP. Assicurati di oscurare le informazioni sensibili come token di accesso, indirizzi email e così via OAuth 2.0.
• Snippet di codice. Se sei in grado di isolare il problema a una particolare sezione di codice o sospetti che il problema sia specifico per una lingua, includi un piccolo snippet illustrare cosa stai facendo.
• Informazioni aggiuntive, come la versione e la piattaforma di runtime/interprete, che potrebbe essere utile ad altri utenti che tentano di riprodurre il problema.

Risolvere il problema

Dopo aver individuato la causa del problema e trovare una soluzione, per implementare una correzione. Se possibile, testa la correzione in un ambiente controllato (come un partner o un inserzionista configurato specificatamente per test) rispetto a una serie di input validi e non validi prima del deployment e produzione.