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

В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые API Google В список включены те ошибки, которые относятся к глобальному (используемому по умолчанию) домену для 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, не было выполнено. Этот ответ означает, что запрошенный документ не был изменен и что должен быть получен кешированный ответ. Проверьте значение заголовка If-None-Match в HTTP-запросе.

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 Обработать пакетный запрос не удалось, так как в нем слишком много частей.
unknownApi API, к которому обращается запрос, не распознан.
unsupportedMediaProtocol Медиапротокол клиента не поддерживается.
unsupportedOutputFormat В значении параметра alt указан формат вывода, который не поддерживается этим сервисом. Проверьте значение параметра запроса alt.
wrongUrlForUpload Обработать запрос на загрузку не удалось из-за неправильного URI. Такие запросы можно отправлять только на URI с префиксом /upload/*. Отправьте запрос на тот же адрес, но с префиксом /upload.

UNAUTHORIZED (401)

Код ошибки Описание
unauthorized У пользователя нет прав для выполнения этого запроса.
authError Для запроса указаны неправильные учетные данные. Проверьте значение заголовка Authorization в HTTP-запросе.
expired Время сеанса истекло. Проверьте значение заголовка Authorization в HTTP-запросе.
lockedDomainExpired Обработать запрос не удалось, так как истек срок действия заблокированного домена.
required Для выполнения этого запроса к API пользователю необходимо войти в систему. Проверьте значение заголовка Authorization в HTTP-запросе.

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 Аккаунт, связанный с указанными в запросе учетными данными, был удален. Проверьте значение заголовка Authorization в HTTP-запросе.
accountDisabled Аккаунт, связанный с указанными в запросе учетными данными, был отключен. Проверьте значение заголовка Authorization в HTTP-запросе.
accountUnverified Адрес электронной почты пользователя, делающего запрос, не подтвержден. Проверьте значение заголовка Authorization в HTTP-запросе.
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 не распознает схему авторизации, используемую для запроса. Проверьте значение заголовка Authorization в HTTP-запросе.
userRateLimitExceeded Обработать запрос не удалось, так как частота запросов от этого пользователя превышает допустимую.
userRateLimitExceededUnreg Обработать запрос не удалось, так как достигнуто ограничение частоты запросов от этого пользователя и в запросе не указан разработчик клиента. Создайте проект для вашего приложения в Google Developer Console: https://console.developers.google.com.
variableTermExpiredDailyExceeded Обработать запрос не удалось, так как истек срок действия временной квоты и была исчерпана стандартная дневная.
variableTermLimitExceeded Обработать запрос не удалось, так как была исчерпана временная квота, действующая в указанный период.

NOT_FOUND (404)

Код ошибки Описание
notFound Не удалось выполнить операцию, так как не найден ресурс, указанный в запросе.
notFound Не найден ресурс, указанный в запросе. Если вы не пользовались этим API в последние две недели, выполните повторное развертывание приложения App Engine и попробуйте вызвать API ещё раз.
unsupportedProtocol Не поддерживается протокол, используемый в запросе.

METHOD_NOT_ALLOWED (405)

Код ошибки Описание
httpMethodNotAllowed Не поддерживается метод HTTP, связанный с запросом.

CONFLICT (409)

Код ошибки Описание
conflict Не удалось выполнить запрос к API, так как запрошенная операция может вызвать конфликт с уже существующим объектом. Например, это случается, если запрашивается создание повторяющегося элемента, однако при таких конфликтах, как правило, ошибки диагностируются более конкретно.
duplicate Не удалось выполнить запрошенную операцию, так как она требует создания уже существующего ресурса.

GONE (410)

Код ошибки Описание
deleted Обработать запрос не удалось, так как указанный в нем ресурс был удален.

PRECONDITION_FAILED (412)

Код ошибки Описание
conditionNotMet Не было выполнено условие, заданное для заголовка If-Match или If-None-Match в HTTP-запросе. Чтобы узнать больше, прочитайте раздел ETag спецификации 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 не готов принимать запросы.