Esistono molti scenari in cui potresti riscontrare errori durante l'utilizzo dell'API Display & Video 360. Potrebbero essere correlati a un bug nel codice, a un input utente non valido o persino a un problema con l'API stessa. Qualunque sia il motivo, sapere come risolvere i problemi è un aspetto importante del processo di sviluppo. Questa guida fornirà alcune best practice per iniziare.
Rivedere le nozioni di base
- Consulta la guida ai prerequisiti. Assicurati di avere accesso a Display & Video 360 e a un progetto API configurato correttamente.
- Se la risposta contiene errori HTTP, assicurati di esaminarli attentamente e di verificare che la richiesta venga effettuata all'API e al servizio corretti.
- Consulta la guida all'autorizzazione. Assicurati che la richiesta contenga le credenziali OAuth 2.0 necessarie.
Verifica di utilizzare le credenziali corrette. Per informazioni dettagliate sulla generazione delle credenziali di autenticazione, consulta la guida alla configurazione dell'applicazione. Puoi anche passare il token di accesso all'endpoint tokeninfo dell'API Google OAuth2 per verificare che sia stato emesso per il progetto API corretto e autorizzato 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": ... }
Informazioni sugli errori
Quando l'API rileva un errore, in genere restituisce una risposta JSON contenente un oggetto error. Questo oggetto fornisce un contesto aggiuntivo sull'errore specifico rilevato.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
Di solito, i contenuti dell'oggetto error contengono informazioni sufficienti per aiutarti a identificare il problema. In caso contrario, potrebbe essere necessario effettuare qualche ricerca aggiuntiva per capire il significato dell'errore.
Ricerca degli errori
Consulta la sezione sugli errori comuni, che fornisce dettagli su alcuni degli errori riscontrati più di frequente.
Se l'errore non è trattato nella sezione degli errori comuni, consulta la documentazione di riferimento e prova a cercare il codice, lo stato e il messaggio di errore.
Se riscontri errori non documentati, non esitare a contattarci.
Identificazione della causa principale
A questo punto avrai identificato l'errore e avrai capito cosa significa. In caso contrario, consulta la sezione Informazioni sugli errori o vai alla sezione Ricevere assistenza se ritieni di aver rilevato un errore nell'API che non riesci a correggere autonomamente.
Prima di poter correggere l'errore, devi identificare 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 codice, devi prima verificare che il codice funzioni come previsto. Come primo passaggio, valuta la possibilità di esaminare la sezione di codice responsabile dell'invio della richiesta con errore per verificare la presenza di problemi evidenti. In alcuni casi potrebbe essere necessario utilizzare uno strumento di debugging per esaminare il codice riga per riga e assicurarsi che funzioni correttamente.
L'esame delle richieste HTTP è un altro modo utile per identificare potenziali bug, nonché casi di input non validi. Molte delle librerie client ufficiali possono essere configurate per registrare le richieste e le risposte HTTP. Per ulteriori dettagli, consulta la documentazione della libreria che preferisci. Un proxy HTTP come Charles, Squid o Fiddler può essere utilizzato anche per acquisire i log delle richieste e delle risposte. Una volta ottenuti questi log, esaminali per assicurarti che i valori dei parametri di richiesta forniti dalla tua applicazione siano corretti e corrispondano a quelli previsti.
Una volta identificato il bug o l'input non valido responsabile dell'errore, la correzione dovrebbe essere ovvia. Tuttavia, se non riesci a procedere o non sai come risolvere al meglio il problema, puoi utilizzare le informazioni raccolte finora per ricevere assistenza.
Richiesta di aiuto
Se non riesci a risolvere un errore autonomamente, puoi contattare il nostro team di assistenza tramite questo modulo disponibile nel Centro assistenza Display & Video 360.
Quando compili questo modulo, ti consigliamo di includere quante più informazioni possibili sul problema che stai riscontrando e sui passaggi per la risoluzione dei problemi che hai già intrapreso. Informazioni utili da includere:
- Log di richieste e risposte HTTP. Assicurati di oscurare le informazioni sensibili, come i token di accesso OAuth 2.0, gli indirizzi email e così via.
- Snippet di codice. Se riesci a isolare il problema in una determinata sezione di codice o sospetti che sia specifico per la lingua, includi un piccolo snippet per illustrare cosa stai facendo.
- Informazioni aggiuntive, come la versione e la piattaforma del runtime/dell'interprete, che potrebbero essere utili per altri che tentano di riprodurre il problema.
Risolvere il problema
Una volta identificata la causa del problema e trovata una soluzione, è giunto il momento di implementare una correzione. Se possibile, testa la correzione in un ambiente controllato (ad esempio un partner o un inserzionista configurato appositamente per i test) su una serie di input validi e non validi prima di eseguire il deployment in produzione.