Questa pagina è stata tradotta dall'API Cloud Translation.

Errori principali

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

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 esegue la richiesta. Controlla la 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 controllare il limite di quota per l'applicazione che effettua la richiesta. Utilizza Google Developers Console per trovare la tua chiave API o riceverne 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 a 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`	La richiesta API non contiene le informazioni richieste. Le informazioni richieste potrebbero essere un parametro o 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`	L'utente deve essere connesso per effettuare questa richiesta API. 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 la 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 Google Developer Console (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.