В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые 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]"
}
}
Ошибки
- MOVED_PERMANENTLY (301)
- SEE_OTHER (303)
- NOT_MODIFIED (304)
- TEMPORARY_REDIRECT (307)
- BAD_REQUEST (400)
- UNAUTHORIZED (401)
- PAYMENT_REQUIRED (402)
- FORBIDDEN (403)
- NOT_FOUND (404)
- METHOD_NOT_ALLOWED (405)
- CONFLICT (409)
- GONE (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- TOO_MANY_REQUESTS (429)
- INTERNAL_SERVER_ERROR (500)
- NOT_IMPLEMENTED (501)
- 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 указан неизвестный формат вывода. |
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 не готов принимать запросы. |
