Messaggi di errore standard

Questo documento individua alcuni dei codici di errore e dei messaggi restituiti dalle API di Google. Nello specifico, gli errori elencati di seguito si trovano nel dominio globale o predefinito per le API di Google. Molte API definiscono anche i propri domini, che individuano errori specifici dell'API che non si trovano nel dominio globale. Per questi errori, il valore della proprietà domain nella risposta JSON sarà un valore specifico dell'API, come youtube.parameter.

Questa pagina elenca gli errori in base ai loro codici di stato HTTP come definiti nel protocollo RFC 7231.

La seguente risposta JSON di esempio mostra come viene comunicato un errore globale:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

Errori

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. UNAUTHORIZED (401)
  7. PAYMENT_REQUIRED (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_ALLOWED (405)
  11. CONFLICT (409)
  12. GONE (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. TOO_MANY_REQUESTS (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

Codice di errore Descrizione
movedPermanently Questa richiesta e le future richieste per la stessa operazione devono essere inviate all'URL specificato nell'intestazione Location di questa risposta anziché all'URL a cui è stata inviata questa richiesta.

SEE_OTHER (303)

Codice di errore Descrizione
seeOther La tua richiesta è stata elaborata correttamente. Per ottenere la risposta, invia una richiesta GET all'URL specificato nell'intestazione Location.
mediaDownloadRedirect La tua richiesta è stata elaborata correttamente. Per ottenere la risposta, invia una richiesta GET all'URL specificato nell'intestazione Location.

NOT_MODIFIED (304)

Codice di errore Descrizione
notModified La condizione impostata per un'intestazione If-None-Match non è stata soddisfatta. Questa risposta indica che il documento richiesto non è stato modificato e che è necessario recuperare una risposta memorizzata nella cache. Verifica il valore dell'intestazione della richiesta HTTP If-None-Match.

TEMPORARY_REDIRECT (307)

Codice di errore Descrizione
temporaryRedirect Per fare in modo che la richiesta venga elaborata, inviala nuovamente all'URL specificato nell'intestazione Location di questa risposta.

BAD_REQUEST (400)

Codice di errore Descrizione
badRequest La richiesta API non è valida o è stata creata in modo errato. Di conseguenza, il server API non è in grado di comprendere la richiesta.
badBinaryDomainRequest La richiesta del dominio binario non è valida.
badContent Il tipo di contenuto dei dati della richiesta o il tipo di contenuto di una parte di una richiesta con più parti non è supportato.
badLockedDomainRequest La richiesta del dominio bloccato non è valida.
corsRequestWithXOrigin La richiesta CORS contiene un'intestazione X-Origin XD3, che è indicativa di una richiesta CORS errata.
endpointConstraintMismatch La richiesta non è andata a buon fine perché non corrisponde all'API specificata. Verifica il valore del percorso dell'URL per assicurarti che sia corretto.
invalid La richiesta non è andata a buon fine perché conteneva un valore non valido. Il valore potrebbe essere un valore parametro, un valore di intestazione o un valore di proprietà.
invalidAltValue Il valore parametro alt specifica un formato di output sconosciuto.
invalidHeader La richiesta non è andata a buon fine perché conteneva un'intestazione non valida.
invalidParameter La richiesta non è andata a buon fine perché conteneva un parametro o un valore parametro non valido. Consulta la documentazione dell'API per determinare quali parametri sono validi per la tua richiesta.
invalidQuery La richiesta non è valida. Consulta la documentazione dell'API per determinare quali parametri sono supportati per la richiesta e verificare se la richiesta contiene una combinazione di parametri non valida o un valore parametro non valido. Verifica il valore del parametro di richiesta q.
keyExpired La chiave API fornita nella richiesta è scaduta, il che significa che il server API non è in grado di controllare il limite di quota per l'applicazione che effettua la richiesta. Visita Google Developers Console per avere ulteriori informazioni o per richiedere una nuova chiave.
keyInvalid La chiave API fornita nella richiesta non è valida, il che significa che il server API non è in grado di controllare il limite di quota per l'applicazione che effettua la richiesta. Utilizza Google Developers Console per trovare la tua chiave API o ottenerne una.
lockedDomainCreationFailure Il token OAuth è stato ricevuto nella stringa di query, che questa API vieta per i formati di risposta diversi da JSON o XML. Se possibile, prova a inviare il token OAuth nell'intestazione Autorizzazione.
notDownload Solo le richieste di download multimediali possono essere inviate ai percorsi dell'URL /download/*. Invia di nuovo la richiesta allo stesso percorso, ma senza il prefisso /download.
notUpload La richiesta non è andata a buon fine perché non è una richiesta di caricamento e solo le richieste di caricamento possono essere inviate agli URI /upload/*. Prova a inviare di nuovo la richiesta allo stesso percorso, ma senza il prefisso /upload.
parseError Il server API non può analizzare il corpo della richiesta.
required La richiesta API non contiene le informazioni richieste. Le informazioni richieste potrebbero essere un parametro o la proprietà di una risorsa.
tooManyParts La richiesta con più parti non è riuscita perché contiene troppe parti.
unknownApi L'API che la richiesta sta chiamando non è riconosciuta.
unsupportedMediaProtocol Il client utilizza un protocollo multimediale non supportato.
unsupportedOutputFormat Il valore parametro alt specifica un formato di output non supportato per questo servizio. Verifica il valore del parametro di richiesta alt.
wrongUrlForUpload La richiesta è una richiesta di caricamento, ma non è andata a buon fine perché non è stata inviata all'URI corretto. Le richieste di caricamento devono essere inviate agli URI che contengono il prefisso /upload/*. Prova a inviare nuovamente la richiesta allo stesso percorso, ma con il prefisso /upload.

UNAUTHORIZED (401)

Codice di errore Descrizione
unauthorized L'utente non è autorizzato a inviare la richiesta.
authError Le credenziali di autorizzazione fornite per la richiesta non sono valide. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
expired La sessione è scaduta. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
lockedDomainExpired La richiesta non è andata a buon fine perché è scaduto un dominio bloccato precedentemente valido.
required Per effettuare questa richiesta API, l'utente deve aver eseguito l'accesso. Verifica il valore dell'intestazione della richiesta HTTP Authorization.

PAYMENT_REQUIRED (402)

Codice di errore Descrizione
dailyLimitExceeded402 È stato raggiunto un limite di budget giornaliero impostato dallo sviluppatore.
quotaExceeded402 L'operazione richiesta richiede più risorse di quelle consentite dalla quota. Per completare l'operazione è richiesto un pagamento.
user402 L'operazione richiesta prevede un qualche tipo di pagamento da parte dell'utente autenticato.

FORBIDDEN (403)

Codice di errore Descrizione
forbidden L'operazione richiesta non è consentita e non può essere completata.
accessNotConfigured Il tuo progetto non è configurato per accedere a questa API. Utilizza Google Developers Console per attivare l'API per il tuo progetto.
accessNotConfigured Il progetto è stato bloccato a causa di un comportamento illecito. Consulta http://support.google.com/code/go/developer_compliance.
accessNotConfigured Il progetto è stato contrassegnato per l'eliminazione.
accountDeleted L'account utente associato alle credenziali di autorizzazione della richiesta è stato eliminato. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
accountDisabled L'account utente associato alle credenziali di autorizzazione della richiesta è stato disattivato. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
accountUnverified L'indirizzo email per l'utente che ha effettuato la richiesta non è stato verificato. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
concurrentLimitExceeded La richiesta non è andata a buon fine perché è stato raggiunto un limite di utilizzo simultaneo.
dailyLimitExceeded È stato raggiunto un limite di quota giornaliero per l'API.
dailyLimitExceeded Il limite della quota giornaliera è stato raggiunto e il progetto è stato bloccato a causa di un comportamento illecito. Consulta il modulo di assistenza per la conformità alle API di Google per risolvere il problema.
dailyLimitExceededUnreg La richiesta non è riuscita perché è stato raggiunto un limite giornaliero per l'utilizzo dell'API non autenticato. L'uso continuato dell'API richiede la registrazione tramite la Google Developers Console.
downloadServiceForbidden L'API non supporta un servizio di download.
insufficientAudience La richiesta non può essere completata per questo pubblico.
insufficientAuthorizedParty La richiesta non può essere completata per questa applicazione.
insufficientPermissions L'utente autenticato non dispone di autorizzazioni sufficienti per eseguire questa richiesta.
limitExceeded La richiesta non può essere completata a causa dei limiti di accesso o di frequenza.
lockedDomainForbidden Questa API non supporta domini bloccati.
quotaExceeded L'operazione richiesta richiede più risorse di quelle consentite dalla quota.
rateLimitExceeded Sono state inviate troppe richieste in un dato intervallo di tempo.
rateLimitExceededUnreg È stato superato un limite di frequenza e devi registrare la tua applicazione per poter continuare a chiamare l'API. Registrati utilizzando Google Developers Console.
responseTooLarge La risorsa richiesta è troppo grande per essere restituita.
servingLimitExceeded Il limite di frequenza globale specificato per l'API è già stato raggiunto.
sslRequired Per eseguire questa operazione è richiesto SSL.
unknownAuth Il server API non riconosce lo schema di autorizzazione utilizzato per la richiesta. Verifica il valore dell'intestazione della richiesta HTTP Authorization.
userRateLimitExceeded La richiesta non è andata a buon fine perché è stato raggiunto un limite di frequenza per utente.
userRateLimitExceededUnreg La richiesta non è andata a buon fine perché è stato raggiunto un limite di frequenza per utente e lo sviluppatore client non è stato identificato nella richiesta. Utilizza la Console per gli sviluppatori di Google (https://console.developers.google.com) per creare un progetto per la tua applicazione.
variableTermExpiredDailyExceeded La richiesta non è andata a buon fine perché è scaduta una quota a termine variabile ed è stato raggiunto un limite giornaliero.
variableTermLimitExceeded La richiesta non è andata a buon fine perché è stato raggiunto un limite di quota a termine variabile.

NOT_FOUND (404)

Codice di errore Descrizione
notFound L'operazione richiesta non è andata a buon fine perché non è stato possibile trovare una risorsa associata alla richiesta.
notFound Non è stato possibile trovare una risorsa associata alla richiesta. Se non hai utilizzato questa API nelle ultime due settimane, esegui nuovamente il deployment dell'app App Engine e prova a chiamarla di nuovo.
unsupportedProtocol Il protocollo utilizzato nella richiesta non è supportato.

METHOD_NOT_ALLOWED (405)

Codice di errore Descrizione
httpMethodNotAllowed Il metodo HTTP associato alla richiesta non è supportato.

CONFLICT (409)

Codice di errore Descrizione
conflict La richiesta API non può essere completata perché l'operazione richiesta sarebbe in conflitto con un elemento esistente. Ad esempio, una richiesta che tenta di creare un elemento duplicato creerebbe un conflitto, anche se gli elementi duplicati vengono in genere identificati con errori più specifici.
duplicate L'operazione richiesta non è andata a buon fine perché ha tentato di creare una risorsa già esistente.

GONE (410)

Codice di errore Descrizione
deleted La richiesta non è andata a buon fine perché la risorsa associata alla richiesta è stata eliminata.

PRECONDITION_FAILED (412)

Codice di errore Descrizione
conditionNotMet La condizione impostata nell'intestazione della richiesta HTTP If-Match o If-None-Match non è stata soddisfatta. Consulta la sezione ETag delle specifiche HTTP per conoscere i dettagli. Verifica il valore dell'intestazione della richiesta HTTP If-Match.

REQUEST_ENTITY_TOO_LARGE (413)

Codice di errore Descrizione
backendRequestTooLarge La richiesta è troppo grande.
batchSizeTooLarge La richiesta in batch contiene troppi elementi.
uploadTooLarge La richiesta non è andata a buon fine perché i dati inviati nella richiesta sono troppo grandi.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

Codice di errore Descrizione
requestedRangeNotSatisfiable La richiesta ha specificato un intervallo che non può essere soddisfatto.

EXPECTATION_FAILED (417)

Codice di errore Descrizione
expectationFailed L'aspettativa del client non può essere soddisfatta dal server.

PRECONDITION_REQUIRED (428)

Codice di errore Descrizione
preconditionRequired La richiesta richiede una condizione preliminare che non è fornita. Affinché questa richiesta vada a buon fine, devi specificare un'intestazione If-Match o If-None-Match insieme alla richiesta.

TOO_MANY_REQUESTS (429)

Codice di errore Descrizione
rateLimitExceeded Sono state inviate troppe richieste in un dato intervallo di tempo.

INTERNAL_SERVER_ERROR (500)

Codice di errore Descrizione
internalError La richiesta non è andata a buon fine a causa di un errore interno.

NOT_IMPLEMENTED (501)

Codice di errore Descrizione
notImplemented L'operazione richiesta non è stata implementata.
unsupportedMethod La richiesta non è andata a buon fine perché sta tentando di eseguire un metodo o un'operazione sconosciuti.

SERVICE_UNAVAILABLE (503)

Codice di errore Descrizione
backendError Si è verificato un errore di backend.
backendNotConnected La richiesta non è andata a buon fine a causa di un errore di connessione.
notReady Il server API non è pronto ad accettare richieste.