В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые 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)
- ВРЕМЕННЫЙ_ПЕРЕДИРЕКТ (307)
- БАД_ЗАПРОС (400)
- НЕСАНКЦИОНИРОВАНО (401)
- ПЛАТЕЖ_ТРЕБУЕМЫЙ (402)
- ЗАПРЕЩЕНО (403)
- НЕ_НАЙДЕНО (404)
- МЕТОД_НЕ_РАЗРЕШЕН (405)
- КОНФЛИКТ (409)
- УШЛО (410)
- ПРЕCONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- ОЖИДАНИЕ_FAILED (417)
- PRECONDITION_REQUIRED (428)
- Too_MANY_REQUESTS (429)
- ВНУТРЕННЯ_СЕРВЕР_ОШИБКА (500)
- НЕ_Реализовано (501)
- СЕРВИС_UNAVAILABLE (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, чтобы найти или получить свой ключ 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 , чтобы активировать 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 . |
downloadServiceForbidden | API не поддерживает службу загрузки. |
insufficientAudience | Запрос не может быть выполнен для этой аудитории. |
insufficientAuthorizedParty | Запрос не может быть выполнен для этого приложения. |
insufficientPermissions | Аутентифицированный пользователь не имеет достаточных разрешений для выполнения этого запроса. |
limitExceeded | Запрос не может быть выполнен из-за ограничений доступа или скорости. |
lockedDomainForbidden | Этот API не поддерживает заблокированные домены. |
quotaExceeded | Запрошенная операция требует больше ресурсов, чем позволяет квота. |
rateLimitExceeded | За заданный промежуток времени было отправлено слишком много запросов. |
rateLimitExceededUnreg | Превышен лимит скорости, и вам необходимо зарегистрировать свое приложение, чтобы иметь возможность продолжать вызывать API. Пожалуйста, зарегистрируйтесь с помощью консоли разработчиков Google . |
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 не готов принимать запросы. |