Ошибки при использовании Indexing API

В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые 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, указанный в заголовке 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 содержит заголовок 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 Для запроса указаны неправильные учетные данные. Проверьте значение заголовка 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 и попробуйте вызвать API ещё раз.
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 не готов принимать запросы.

Ошибки, связанные непосредственно с Indexing API

Во всех описанных ниже ситуациях запрос отклоняется, а Googlebot не сканирует соответствующий URL. То же происходит в случае основных ошибок.

BAD_REQUEST (400)

Сообщение об ошибке Описание
Missing attribute. 'url' attribute is required. Пользователь не указал URL в запросе.
Invalid attribute. 'url' is not in standard URL format Пользователь указал URL в неверном формате, например abcd.
Unknown type. 'type' attribute is required and must be 'URL_REMOVED' or 'URL_UPDATED'. Пользователь не указал тип уведомления.
Invalid value at 'url_notification.type' (TYPE_ENUM) Пользователь указал в типе уведомления не URL_REMOVED или URL_UPDATED, а другое значение.

FORBIDDEN (403)

Сообщение об ошибке Описание
Permission denied. Failed to verify the URL ownership. Пользователь не прошел процедуру подтверждения права собственности или пытается обновить URL, который ему не принадлежит.

TOO_MANY_REQUESTS (429)

Сообщение об ошибке Описание
Insufficient tokens for quota 'indexing.googleapis.com/default_requests' Пользователь превышает свою квоту Indexing API.