Risposte di errore

Quando una richiesta API va a buon fine, l'API restituisce un codice di stato 200 OK insieme ai dati richiesti nel corpo della risposta. Se si verifica un errore, l'API restituisce uno dei codici di errore canonici definiti dalle API di Google, mappati a un codice di stato HTTP e un corpo della risposta contenente informazioni sull'errore. Quando si verifica un errore, esamina i campi message e status nel corpo della risposta JSON per dettagli specifici che ti aiutino a eseguire il debug.

Formato dell'errore

Se una richiesta genera un errore, l'API restituisce un codice di stato HTTP appropriato e un corpo della risposta JSON. La risposta di errore contiene un oggetto error con la seguente struttura:

{
  "error": {
    "code": 403,
    "message": "User does not have sufficient permissions for this property.",
    "status": "PERMISSION_DENIED"
  }
}

L'oggetto error contiene i seguenti campi:

Campo Descrizione
code Il codice di stato HTTP, ad esempio 400, 401, 403, 429 o 500.
message Una breve descrizione dell'errore.
status Il codice di errore canonico, ad esempio INVALID_ARGUMENT, UNAUTHENTICATED, PERMISSION_DENIED, RESOURCE_EXHAUSTED o INTERNAL.

Errori comuni

La tabella seguente elenca gli errori comuni restituiti dall'API.

Codice di stato HTTP Codice canonico Motivo Descrizione
400 INVALID_ARGUMENT Richiesta errata La richiesta non è in un formato corretto. Ciò può essere causato da parametri mancanti o non validi, ad esempio un intervallo di date errato o un filtro in un formato non corretto.
401 UNAUTHENTICATED Credenziali non valide La richiesta non ha credenziali di autenticazione valide per la risorsa di destinazione. Questo può accadere se il token di accesso OAuth 2.0 è mancante, non valido o scaduto. Segui le istruzioni riportate in Autenticazione con OAuth 2.0 per ottenere un token valido.
403 PERMISSION_DENIED Autorizzazioni insufficienti L'utente autenticato non ha accesso alla proprietà Google Analytics richiesta.
429 RESOURCE_EXHAUSTED Quota superata La richiesta è stata rifiutata perché sono stati raggiunti i limiti di quota dell'API. Per ulteriori informazioni, consulta Limiti e quote dell'API Data. Potresti superare i limiti per progetto o per proprietà.
500 INTERNAL Errore interno del server Si è verificato un errore del server imprevisto. In genere si tratta di un problema temporaneo. Ti consigliamo di riprovare a inviare la richiesta con il backoff esponenziale. Per evitare di superare le quote di errori del server, è importante implementare il backoff esponenziale con limiti di nuovi tentativi.
503 UNAVAILABLE Servizio non disponibile Servizio temporaneamente non disponibile. In genere si tratta di un problema temporaneo. Ti consigliamo di riprovare a inviare la richiesta con il backoff esponenziale. Per evitare di superare le quote di errori del server, è importante implementare il backoff esponenziale con limiti di nuovi tentativi.