Стандартные сообщения об ошибках

В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые 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]"
 }
}

Ошибки

  1. ПЕРЕМЕЩЕНО_ПОСТОЯННО (301)
  2. SEE_OTHER (303)
  3. НЕ_МОДИФИЦИРОВАНО (304)
  4. ВРЕМЕННЫЙ_ПЕРЕДИРЕКТ (307)
  5. БАД_ЗАПРОС (400)
  6. НЕСАНКЦИОНИРОВАНО (401)
  7. ПЛАТЕЖ_НЕОБХОДИМЫЙ (402)
  8. ЗАПРЕЩЕНО (403)
  9. НЕ_НАЙДЕНО (404)
  10. МЕТОД_НЕ_РАЗРЕШЕН (405)
  11. КОНФЛИКТ (409)
  12. УШЛО (410)
  13. ПРЕCONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. ОЖИДАНИЕ_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. Too_MANY_REQUESTS (429)
  19. ВНУТРЕННЯ_СЕРВЕР_ОШИБКА (500)
  20. НЕ_Реализовано (501)
  21. СЕРВИС_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 не готов принимать запросы.