В этом документе указаны некоторые коды ошибок и сообщения, которые возвращают API Google. В частности, перечисленные здесь ошибки относятся к глобальному домену или домену по умолчанию для API Google. Многие API также определяют свои собственные домены, которые идентифицируют ошибки, характерные для API, которые не относятся к глобальному домену. Для этих ошибок значением свойства domain
в ответе JSON будет значение, зависящее от API, например youtube.parameter
.
На этой странице ошибки перечислены по их кодам состояния HTTP, как определено в RFC 7231 .
Пример ответа JSON ниже демонстрирует, как сообщается о глобальной ошибке:
{ "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]" } }
Ошибки
- ПЕРЕМЕЩЕНО_ПОСТОЯННО (301)
- SEE_OTHER (303)
- НЕ_ИЗМЕНЕНО (304)
- TEMPORARY_REDIRECT (307)
- ПЛОХОЙ_ЗАПРОС (400)
- НЕСАНКЦИОНИРОВАННЫЙ (401)
- PAYMENT_REQUIRED (402)
- ЗАПРЕЩЕНО (403)
- НЕ НАЙДЕНО (404)
- METHOD_NOT_ALLOWED (405)
- КОНФЛИКТ (409)
- УШЕЛ (410)
- ПРЕДУСЛОВИЕ_ОШИБКА (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- ПРЕДУСЛОВИЕ_ОБЯЗАТЕЛЬНО (428)
- TOO_MANY_REQUESTS (429)
- ВНУТРЕННЯЯ_СЕРВЕРНАЯ_ОШИБКА (500)
- НЕ_РЕАЛИЗОВАННО (501)
- СЕРВИС_НЕДОСТУПЕН (503)
MOVED_PERMANENTLY (301)
Код ошибки | Описание |
---|---|
movedPermanently | Этот запрос и будущие запросы на ту же операцию должны быть отправлены на URL-адрес, указанный в заголовке Location этого ответа, а не на URL-адрес, на который был отправлен этот запрос. |
SEE_OTHER (303)
Код ошибки | Описание |
---|---|
seeOther | Ваш запрос успешно обработан. Чтобы получить ответ, отправьте запрос GET на URL-адрес, указанный в заголовке Location . |
mediaDownloadRedirect | Ваш запрос успешно обработан. Чтобы получить ответ, отправьте запрос GET на URL-адрес, указанный в заголовке Location . |
NOT_MODIFIED (304)
Код ошибки | Описание |
---|---|
notModified | Условие, установленное для заголовка If-None-Match, не было выполнено. Этот ответ указывает, что запрошенный документ не был изменен и что следует получить кэшированный ответ. Проверьте значение заголовка HTTP-запроса If-None-Match . |
TEMPORARY_REDIRECT (307)
Код ошибки | Описание |
---|---|
temporaryRedirect | Чтобы ваш запрос был обработан, повторно отправьте его на URL-адрес, указанный в заголовке Location этого ответа. |
BAD_REQUEST (400)
Код ошибки | Описание |
---|---|
badRequest | Запрос API недействителен или неправильно сформирован. Следовательно, сервер API не смог понять запрос. |
badBinaryDomainRequest | Запрос двоичного домена недействителен. |
badContent | Тип содержимого данных запроса или тип содержимого части составного запроса не поддерживается. |
badLockedDomainRequest | Запрос заблокированного домена недействителен. |
corsRequestWithXOrigin | Запрос CORS содержит заголовок XD3 X-Origin, что указывает на неверный запрос CORS. |
endpointConstraintMismatch | Запрос не выполнен, так как он не соответствует указанному API. Проверьте значение пути URL, чтобы убедиться, что оно правильное. |
invalid | Запрос не выполнен, так как содержит недопустимое значение. Значение может быть значением параметра, значением заголовка или значением свойства. |
invalidAltValue | Значение параметра alt указывает на неизвестный формат вывода. |
invalidHeader | Запрос не выполнен, так как содержит недопустимый заголовок. |
invalidParameter | Запрос не выполнен, так как содержит недопустимый параметр или значение параметра. Просмотрите документацию API, чтобы определить, какие параметры допустимы для вашего запроса. |
invalidQuery | Запрос недействителен. Просмотрите документацию по API, чтобы определить, какие параметры поддерживаются для запроса, и проверьте, содержит ли запрос недопустимую комбинацию параметров или недопустимое значение параметра. Проверьте значение параметра запроса q . |
keyExpired | Срок действия ключа API, предоставленного в запросе, истек, что означает, что сервер API не может проверить ограничение квоты для приложения, отправляющего запрос. Проверьте консоль разработчиков Google для получения дополнительной информации или получения нового ключа. |
keyInvalid | Ключ API, предоставленный в запросе, недействителен, что означает, что сервер API не может проверить ограничение квоты для приложения, отправляющего запрос. Используйте Google Developers Console , чтобы найти свой ключ API или получить его. |
lockedDomainCreationFailure | Токен OAuth был получен в строке запроса, что этот API запрещает для форматов ответа, отличных от JSON или XML. Если возможно, попробуйте вместо этого отправить токен OAuth в заголовке авторизации. |
notDownload | На URL-адреса /download/* можно отправлять только запросы на загрузку мультимедиа. Повторно отправьте запрос по тому же пути, но без префикса /download . |
notUpload | Запрос не выполнен, так как это не запрос на загрузку, а на URI /upload/* можно отправлять только запросы на загрузку. Попробуйте повторно отправить запрос по тому же пути, но без префикса /upload . |
parseError | Сервер API не может проанализировать тело запроса. |
required | В запросе API отсутствует необходимая информация. Необходимая информация может быть параметром или свойством ресурса. |
tooManyParts | Не удалось выполнить составной запрос, так как он содержит слишком много частей. |
unknownApi | API, к которому обращается запрос, не распознан. |
unsupportedMediaProtocol | Клиент использует неподдерживаемый медиа-протокол. |
unsupportedOutputFormat | Значение параметра alt указывает выходной формат, который не поддерживается для этой службы. Проверьте значение параметра запроса alt . |
wrongUrlForUpload | Запрос представляет собой запрос на загрузку, но он завершился неудачно, поскольку он не был отправлен на правильный URI. Запросы на загрузку должны отправляться на URI, содержащие префикс /upload/* . Попробуйте повторно отправить запрос по тому же пути, но с префиксом /upload . |
UNAUTHORIZED (401)
Код ошибки | Описание |
---|---|
unauthorized | Пользователь не авторизован для отправки запроса. |
authError | Учетные данные авторизации, предоставленные для запроса, недействительны. Проверьте значение заголовка HTTP-запроса Authorization . |
expired | Сессия просрочена. Проверьте значение заголовка HTTP-запроса Authorization . |
lockedDomainExpired | Запрос не выполнен, поскольку срок действия ранее действительного заблокированного домена истек. |
required | Пользователь должен войти в систему, чтобы сделать этот запрос API. Проверьте значение заголовка HTTP-запроса Authorization . |
PAYMENT_REQUIRED (402)
Код ошибки | Описание |
---|---|
dailyLimitExceeded402 | Достигнут предел дневного бюджета, установленный разработчиком. |
quotaExceeded402 | Запрошенная операция требует больше ресурсов, чем позволяет квота. Для завершения операции требуется оплата. |
user402 | Запрошенная операция требует некоторой оплаты от аутентифицированного пользователя. |
FORBIDDEN (403)
Код ошибки | Описание |
---|---|
forbidden | Запрошенная операция запрещена и не может быть завершена. |
accessNotConfigured | Ваш проект не настроен для доступа к этому API. Пожалуйста, используйте Google Developers Console , чтобы активировать API для вашего проекта. |
accessNotConfigured | Проект заблокирован из-за злоупотреблений. См. http://support.google.com/code/go/developer_compliance . |
accessNotConfigured | Проект помечен на удаление. |
accountDeleted | Учетная запись пользователя, связанная с учетными данными авторизации запроса, была удалена. Проверьте значение заголовка HTTP-запроса Authorization . |
accountDisabled | Учетная запись пользователя, связанная с учетными данными авторизации запроса, отключена. Проверьте значение заголовка HTTP-запроса Authorization . |
accountUnverified | Адрес электронной почты пользователя, делающего запрос, не подтвержден. Проверьте значение заголовка HTTP-запроса Authorization . |
concurrentLimitExceeded | Запрос не выполнен, так как достигнут предел одновременного использования. |
dailyLimitExceeded | Достигнут предел дневной квоты для API. |
dailyLimitExceeded | Достигнут предел дневной квоты, и проект заблокирован из-за злоупотреблений. См. форму поддержки соответствия API Google , чтобы помочь решить проблему. |
dailyLimitExceededUnreg | Запрос не выполнен, так как достигнуто дневное ограничение на использование API без проверки подлинности. Для дальнейшего использования API требуется регистрация через Google Developers Console . |
downloadServiceForbidden | API не поддерживает службу загрузки. |
insufficientAudience | Запрос не может быть выполнен для этой аудитории. |
insufficientAuthorizedParty | Запрос не может быть выполнен для этого приложения. |
insufficientPermissions | У аутентифицированного пользователя недостаточно прав для выполнения этого запроса. |
limitExceeded | Запрос не может быть выполнен из-за ограничений доступа или скорости. |
lockedDomainForbidden | Этот API не поддерживает заблокированные домены. |
quotaExceeded | Запрошенная операция требует больше ресурсов, чем позволяет квота. |
rateLimitExceeded | За заданный промежуток времени было отправлено слишком много запросов. |
rateLimitExceededUnreg | Превышено ограничение скорости, и вы должны зарегистрировать свое приложение, чтобы иметь возможность продолжать вызывать API. Пожалуйста, зарегистрируйтесь с помощью Google Developers Console . |
responseTooLarge | Запрошенный ресурс слишком велик для возврата. |
servingLimitExceeded | Общий предел скорости, указанный для API, уже достигнут. |
sslRequired | Для выполнения этой операции требуется SSL. |
unknownAuth | Сервер API не распознает схему авторизации, используемую для запроса. Проверьте значение заголовка HTTP-запроса Authorization . |
userRateLimitExceeded | Запрос не выполнен, так как достигнут предел скорости для каждого пользователя. |
userRateLimitExceededUnreg | Запрос завершился неудачно, так как было достигнуто ограничение скорости для каждого пользователя, а разработчик клиента не был идентифицирован в запросе. Используйте консоль разработчика Google (https://console.developers.google.com), чтобы создать проект для своего приложения. |
variableTermExpiredDailyExceeded | Запрос завершился неудачно, так как истек срок действия квоты переменного срока и был достигнут дневной лимит. |
variableTermLimitExceeded | Запрос не выполнен, так как достигнут предел квоты переменного термина. |
NOT_FOUND (404)
Код ошибки | Описание |
---|---|
notFound | Запрошенная операция завершилась неудачно, так как не удалось найти ресурс, связанный с запросом. |
notFound | Ресурс, связанный с запросом, не найден. Если вы не использовали этот API в течение последних двух недель, повторно разверните приложение App Engine и попробуйте вызвать его снова. |
unsupportedProtocol | Протокол, используемый в запросе, не поддерживается. |
METHOD_NOT_ALLOWED (405)
Код ошибки | Описание |
---|---|
httpMethodNotAllowed | Метод HTTP, связанный с запросом, не поддерживается. |
CONFLICT (409)
Код ошибки | Описание |
---|---|
conflict | Запрос API не может быть выполнен, так как запрошенная операция будет конфликтовать с существующим элементом. Например, запрос, который пытается создать повторяющийся элемент, может привести к конфликту, хотя повторяющиеся элементы обычно идентифицируются с более конкретными ошибками. |
duplicate | Запрошенная операция завершилась неудачно, поскольку она пыталась создать уже существующий ресурс. |
GONE (410)
Код ошибки | Описание |
---|---|
deleted | Запрос не выполнен, так как ресурс, связанный с запросом, был удален. |
PRECONDITION_FAILED (412)
Код ошибки | Описание |
---|---|
conditionNotMet | Условие, заданное в заголовке HTTP-запроса If-Match или If-None-Match , не выполнено. См. подробности в разделе ETag спецификации HTTP. Проверьте значение заголовка HTTP-запроса If-Match . |
REQUEST_ENTITY_TOO_LARGE (413)
Код ошибки | Описание |
---|---|
backendRequestTooLarge | Запрос слишком большой. |
batchSizeTooLarge | Пакетный запрос содержит слишком много элементов. |
uploadTooLarge | Запрос не выполнен, поскольку данные, отправленные в запросе, слишком велики. |
REQUESTED_RANGE_NOT_SATISFIABLE (416)
Код ошибки | Описание |
---|---|
requestedRangeNotSatisfiable | В запросе указан диапазон, который не может быть удовлетворен. |
EXPECTATION_FAILED (417)
Код ошибки | Описание |
---|---|
expectationFailed | Ожидание клиента не может быть удовлетворено сервером. |
PRECONDITION_REQUIRED (428)
Код ошибки | Описание |
---|---|
preconditionRequired | Запрос требует предварительного условия, которое не предоставляется. Чтобы этот запрос был успешным, вам необходимо предоставить заголовок If-Match или If-None-Match вместе с запросом. |
TOO_MANY_REQUESTS (429)
Код ошибки | Описание |
---|---|
rateLimitExceeded | За заданный промежуток времени было отправлено слишком много запросов. |
INTERNAL_SERVER_ERROR (500)
Код ошибки | Описание |
---|---|
internalError | Запрос не выполнен из-за внутренней ошибки. |
NOT_IMPLEMENTED (501)
Код ошибки | Описание |
---|---|
notImplemented | Запрошенная операция не выполнена. |
unsupportedMethod | Запрос не выполнен, так как он пытается выполнить неизвестный метод или операцию. |
SERVICE_UNAVAILABLE (503)
Код ошибки | Описание |
---|---|
backendError | Произошла ошибка серверной части. |
backendNotConnected | Запрос не выполнен из-за ошибки соединения. |
notReady | Сервер API не готов принимать запросы. |