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)
- SEE_OTHER (303)
- NOT_MODIFIED (304)
- TEMPORARY_REDIRECT (307)
- BAD_REQUEST (400)
- UNAUTHORIZED (401)
- PAYMENT_REQUIRED (402)
- FORBIDDEN (403)
- NOT_FOUND (404)
- METHOD_NOT_ALLOWED (405)
- CONFLICT (409)
- GONE (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- TOO_MANY_REQUESTS (429)
- INTERNAL_SERVER_ERROR (500)
- NOT_IMPLEMENTED (501)
- 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. Controlla 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. |
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. Consulta 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 la Google Developers Console per trovare la tua chiave API o per 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 invece 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 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 |
L'utente deve aver effettuato l'accesso per inviare 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 mediante 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. 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 client non è stato identificato nella richiesta. Utilizza la Google Developer Console (https://developers.google.com/console) 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. |