Messaggi di errore

Questo documento identifica alcuni dei codici e messaggi di errore restituiti dalle API di Google. In particolare, gli errori elencati qui si trovano nel dominio globale o predefinito per le API di Google. Molte API definiscono anche i propri domini, che identificano 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 per l'API, ad esempio youtube.parameter.

In questa pagina gli errori vengono elencati in base ai codici di stato HTTP come definito nell'RFC 7231.

La risposta JSON di esempio riportata di seguito 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

MOVED_PERMANENTLY (301) [MOVED_PERMANENTE]

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 la 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`.

NON_MODIFICATO (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. Controlla 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 è riuscito a 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 che il valore del percorso dell'URL sia corretto.
`invalid`	La richiesta non è andata a buon fine perché conteneva un valore non valido. Il valore può 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 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 verificare il limite di quota per l'applicazione che effettua la richiesta. Consulta Google Developers Console per ulteriori informazioni o per ottenere una nuova chiave.
`keyInvalid`	La chiave API fornita nella richiesta non è valida, il che significa che il server API non è in grado di verificare 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 formati di risposta diversi da JSON o XML. Se possibile, prova a inviare il token OAuth nell'intestazione Authorization.
`notDownload`	Solo le richieste di download di contenuti 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 nuovamente la richiesta allo stesso percorso, ma senza il prefisso `/upload`.
`parseError`	Il server API non può analizzare il corpo della richiesta.
`required`	Nella richiesta API mancano informazioni obbligatorie. Le informazioni richieste possono essere un parametro o una proprietà della risorsa.
`tooManyParts`	La richiesta con più parti non è riuscita perché contiene troppe parti
`unknownApi`	L'API chiamata dalla richiesta 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`.

NON AUTORIZZATO (401)

Codice di errore	Descrizione
`unauthorized`	L'utente non è autorizzato a effettuare la richiesta.
`authError`	Le credenziali di autorizzazione fornite per la richiesta non sono valide. Controlla il valore dell'intestazione della richiesta HTTP `Authorization`.
`expired`	Sessione scaduta. Controlla il valore dell'intestazione della richiesta HTTP `Authorization`.
`lockedDomainExpired`	La richiesta non è andata a buon fine perché un dominio bloccato precedentemente valido è scaduto.
`required`	L'utente deve aver eseguito l'accesso per effettuare questa richiesta API. Controlla 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 richiede un qualche tipo di pagamento da parte dell'utente autenticato.

VIETATO (403)

Codice di errore	Descrizione
`forbidden`	L'operazione richiesta è vietata e non può essere completata.
`accessNotConfigured`	Il progetto non è configurato per accedere a questa API. Utilizza Google Developers Console per attivare l'API per il progetto.
`accessNotConfigured`	Il progetto è stato bloccato a causa di un abuso. Consulta la pagina 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. Controlla il valore dell'intestazione della richiesta HTTP `Authorization`.
`accountDisabled`	L'account utente associato alle credenziali di autorizzazione della richiesta è stato disattivato. Controlla il valore dell'intestazione della richiesta HTTP `Authorization`.
`accountUnverified`	L'indirizzo email dell'utente che ha effettuato la richiesta non è stato verificato. Controlla 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 giornaliera per l'API.
`dailyLimitExceeded`	È stato raggiunto il limite di quota giornaliera e il progetto è stato bloccato a causa di un abuso. Per risolvere il problema, consulta il modulo di assistenza per la conformità delle API di Google.
`dailyLimitExceededUnreg`	La richiesta non è andata a buon fine perché è stato raggiunto un limite giornaliero per l'utilizzo non autenticato dell'API. L'uso continuativo dell'API richiede la registrazione tramite Google Developers Console.
`downloadServiceForbidden`	L'API non supporta i servizi di download.
`insufficientAudience`	Impossibile completare la richiesta per questo segmento di pubblico.
`insufficientAuthorizedParty`	Impossibile completare la richiesta per questa richiesta.
`insufficientPermissions`	L'utente autenticato non dispone di autorizzazioni sufficienti per eseguire questa richiesta.
`limitExceeded`	La richiesta non può essere completata a causa di limitazioni di accesso o di frequenza.
`lockedDomainForbidden`	Questa API non supporta i domini bloccati.
`quotaExceeded`	L'operazione richiesta richiede più risorse di quelle consentite dalla quota.
`rateLimitExceeded`	Sono state inviate troppe richieste in un determinato periodo 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`	È già stato raggiunto il limite di frequenza complessivo specificato per l'API.
`sslRequired`	Per eseguire questa operazione è necessario il protocollo SSL.
`unknownAuth`	Il server API non riconosce lo schema di autorizzazione utilizzato per la richiesta. Controlla 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 del cliente 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.

NON_TROVATO (404)

Codice di errore	Descrizione
`notFound`	L'operazione richiesta non è riuscita perché non è stato possibile trovare una risorsa associata alla richiesta.
`notFound`	Impossibile 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.

CONFLITTO (409)

Codice di errore	Descrizione
`conflict`	Impossibile completare la richiesta API 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 in genere vengono identificati con errori più specifici.
`duplicate`	L'operazione richiesta non è riuscita perché ha tentato di creare una risorsa già esistente.

LORO (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` della richiesta non è stata soddisfatta. Consulta la sezione ETag delle specifiche HTTP per i dettagli. Controlla 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 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.

PRE CONDIZIONE_RICHIESTA (428)

Codice di errore	Descrizione
`preconditionRequired`	La richiesta richiede una condizione preliminare che non è fornita. Affinché questa richiesta abbia esito positivo, devi fornire 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 determinato periodo 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'operazione o un metodo sconosciuto.

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.