Основные ошибки

В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые API Google и относящиеся к глобальному домену (домену по умолчанию). Многие API также определяют собственные домены, в которых могут быть свои ошибки, отсутствующие в глобальном домене. У таких ошибок в ответе JSON будет указано значение свойства domain, относящееся к конкретному 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]"
 }
}

Ошибки

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. UNAUTHORIZED (401)
  7. PAYMENT_REQUIRED (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_ALLOWED (405)
  11. CONFLICT (409)
  12. GONE (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. TOO_MANY_REQUESTS (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

Код ошибки Описание
movedPermanently Вместо текущего URL этот и все последующие запросы должны отправляться на URL, указанный в заголовке Location полученного ответа.

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 содержит заголовок X-Origin XD3, то есть этот запрос составлен неправильно.
endpointConstraintMismatch Обработать запрос не удалось, так как он не соответствует указанному API. Убедитесь, что вы указали правильный URL.
invalid Обработать запрос не удалось, так как он содержал недопустимое значение. Это может быть значение параметра, заголовка или свойства.
invalidAltValue В значении параметра alt указан неизвестный формат вывода.
invalidHeader Обработать запрос не удалось, так как он содержал недопустимый заголовок.
invalidParameter Обработать запрос не удалось, так как он содержал недопустимый параметр или значение параметра. Чтобы определить, какие параметры можно использовать для запроса, прочитайте документацию API.
invalidQuery Запрос недействителен. Узнайте, какие параметры можно использовать для запроса, и убедитесь, что запрос не содержит недопустимую комбинацию параметров или недействительные значения параметров. Для этого изучите документацию API. Проверьте значение параметра q.
keyExpired Срок действия ключа API, указанного в запросе, истек. Это означает, что сервер API не может проверить лимит квоты для приложения, отправляющего запрос. Чтобы узнать больше или получить новый ключ, перейдите в Google Developers Console.
keyInvalid Указанный в запросе ключ API недействителен. Это означает, что сервер API не может проверить лимит квоты для приложения, делающего запрос. Попробуйте найти ключ в Google Developers Console или получите новый.
lockedDomainCreationFailure Токен OAuth был получен в строке запроса. API запрещает это для всех форматов ответа кроме JSON и XML. Попробуйте отправить токен OAuth в заголовке Authorization.
notDownload На путь URL /download/* могут быть отправлены только запросы на скачивание мультимедийных данных. Отправьте повторный запрос с тем же путем, но без префикса /download.
notUpload Обработать запрос не удалось, так как он не является запросом на загрузку. На пути URI с префиксом /upload/* можно отправлять только такие запросы. Отправьте повторный запрос с тем же путем, но без префикса /upload.
parseError Сервер API не может обработать тело запроса.
required В запросе отсутствует обязательная информация. Возможно, это параметр или свойство ресурса.
tooManyParts Не удалось обработать запрос типа multipart, так как он содержит слишком много частей.
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. Активируйте API для проекта в Google Developers Console.
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 Developer Console (https://developers.google.com/console).
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 не готов принимать запросы.