Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом документе указаны некоторые коды ошибок и сообщения, возвращаемые API Google. В частности, перечисленные здесь ошибки относятся к глобальному домену или домену по умолчанию для API Google. Многие API также определяют свои собственные домены, которые идентифицируют ошибки, специфичные для API, которые не входят в глобальный домен. В случае этих ошибок значение свойства domain в ответе JSON будет значением, специфичным для API, например youtube.parameter .
На этой странице перечислены ошибки по их кодам состояния HTTP, как определено в RFC 7231 .
Пример ответа JSON ниже демонстрирует, как сообщается о глобальной ошибке:
Этот запрос и будущие запросы на ту же операцию должны быть отправлены на 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 .
Запрос не выполнен, поскольку достигнут дневной лимит на использование 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
Запрос не выполнен, поскольку он пытается выполнить неизвестный метод или операцию.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-11-08 UTC."],[],[]]