Esistono molti scenari in cui potresti riscontrare errori quando lavori con l'API Display & Video 360. Potrebbero essere correlati a un bug nel codice, a un input utente non valido o persino a un problema dell'API stessa. Qualunque sia la ragione, sapere come risolvere gli errori è una parte importante del processo di sviluppo. Questa guida fornisce alcuni suggerimenti di best practice per iniziare.
Ripasso delle nozioni di base
- Consulta la guida ai prerequisiti. Assicurati di avere accesso a Display & Video 360 e di un progetto API configurato correttamente.
- Se la tua risposta contiene errori HTTP, esaminali con attenzione e assicurati 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 maggiori dettagli sulla generazione delle credenziali di autenticazione, consulta la guida relativa alla configurazione dell'applicazione. Puoi anche passare il token di accesso all'endpoint tokeninfo dell'API Google OAuth2 per verificare che venga inviato al 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": ... }
Comprensione degli errori
Quando l'API rileva un errore, solitamente restituisce una risposta JSON contenente un oggetto error. Questo oggetto fornisce un contesto aggiuntivo sull'errore specifico che si è verificato.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
Generalmente i contenuti dell'oggetto error contengono informazioni sufficienti a
identificare l'errore. In caso contrario, potresti dover fare altre
ricerche 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 è indicato nella sezione degli errori comuni, consulta la documentazione di riferimento e prova a cercare il codice, lo stato e il messaggio di errore.
Se rilevi errori non documentati, ti invitiamo a comunicarcelo.
Identificare la causa principale
A questo punto hai identificato l'errore e ne hai compreso il significato. In caso contrario, torna alla sezione per comprendere gli errori oppure passa alla richiesta di assistenza se ritieni di aver trovato un errore nell'API che non riesci a correggere autonomamente.
Prima di correggere l'errore, devi 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, devi prima verificare che il codice funzioni come previsto. Per prima cosa, valuta di rivedere la sezione di codice responsabile dell'invio della richiesta non riuscita per verificare la presenza di problemi evidenti. In alcuni casi, potrebbe essere necessario utilizzare uno strumento di debug per analizzare il codice riga per riga e garantirne il corretto funzionamento.
L'esame delle richieste HTTP è un altro modo utile per identificare potenziali bug e i casi di input non validi. Molte delle librerie client ufficiali possono essere configurate per registrare richieste e risposte HTTP. Per ulteriori dettagli, consulta la documentazione relativa alla libreria di tua scelta. Per acquisire i log delle richieste e delle risposte, puoi utilizzare anche un proxy HTTP come Charles, Squid o sentirephy. Una volta ottenuti questi log, esaminali per assicurarti che i valori dei parametri di richiesta forniti dall'applicazione siano corretti e corrispondano a quanto previsto.
Una volta identificato il bug o l'input non valido responsabile dell'errore, si spera che la correzione sia evidente. Se non riesci a risolvere il problema o non sai come risolvere il problema, puoi utilizzare le informazioni raccolte finora per ricevere assistenza.
Richiesta di aiuto
Se non riesci a risolvere autonomamente un errore, puoi contattare il nostro team di assistenza tramite questo modulo disponibile nel Centro assistenza Display & Video 360.
Quando compili questo modulo, dovresti includere quante più informazioni possibili sul problema riscontrato e sulla procedura per la risoluzione che hai già eseguito. Informazioni utili da includere:
- Log delle richieste e delle risposte HTTP. Assicurati di oscurare informazioni sensibili come token di accesso OAuth 2.0, indirizzi email e così via.
- Snippet di codice. Se riesci a isolare il problema a una determinata sezione di codice o a sospettare che il problema sia specifico di una lingua, includi un piccolo snippet per illustrare ciò che stai facendo.
- Informazioni aggiuntive, come la piattaforma e la versione dell'interprete/runtime, che potrebbero essere utili per altri utenti che tentano di riprodurre il problema.
Risolvere il problema
Una volta identificata la causa del problema e trovata una soluzione, è il momento di implementare una correzione. Se possibile, testa la correzione in un ambiente controllato (ad esempio un partner o un inserzionista configurato specificamente per i test) confrontandolo con una serie di input validi e non validi prima di eseguire il deployment nella produzione.