YouTube Data API - Errors
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом документе описаны различные типы ошибок, которые могут возвращать операции YouTube Data API . Список ошибок для каждого отдельного метода также можно найти в справочной документации к этому методу.
Общие ошибки
В приведенных ниже таблицах указаны сообщения об ошибках API, не относящиеся к конкретному методу API.
Core API errors
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
forbidden
Доступ запрещен. Запрос может быть некорректно авторизован.
quotaExceeded (403)
quotaExceeded
Запрос не может быть выполнен, поскольку вы превысили свою квоту .
Common request errors
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
incompatibleParameters
В запросе указываются два или более параметров, которые нельзя использовать в одном запросе.
badRequest (400)
invalidFilters
В запросе указан недопустимый параметр фильтра.
badRequest (400)
invalidPageToken
В запросе указан недействительный токен страницы.
badRequest (400)
missingRequiredParameter
В запросе отсутствует обязательный параметр.
badRequest (400)
unexpectedParameter
В запросе указан неожиданный параметр.
forbidden (403)
accountDelegationForbidden
Авторизованный пользователь не может действовать от имени указанной учетной записи Google.
forbidden (403)
authenticatedUserAccountClosed
Аккаунт YouTube авторизованного пользователя закрыт. Если авторизованный пользователь действует от имени другого аккаунта Google, то эта ошибка относится к последнему.
forbidden (403)
authenticatedUserAccountSuspended
Аккаунт YouTube авторизованного пользователя заблокирован. Если авторизованный пользователь действует от имени другого аккаунта Google, то эта ошибка относится к последнему.
forbidden (403)
authenticatedUserNotChannel
Для этого запроса аутентифицированный пользователь должен перейти в канал, но этого не происходит. Если ваш запрос аутентифицирован и использует параметр делегирования onBehalfOfContentOwner , то вам также следует установить параметр onBehalfOfContentOwnerChannel .
forbidden (403)
channelClosed
Канал, указанный в запросе, закрыт.
forbidden (403)
channelNotFound
Канал, указанный в запросе, не найден.
forbidden (403)
channelSuspended
Указанный в запросе канал заблокирован.
forbidden (403)
cmsUserAccountNotFound
Пользователю CMS запрещено действовать от имени указанного владельца контента.
forbidden (403)
insufficientCapabilities
Пользователь CMS обладает недостаточными возможностями.
forbidden (403)
insufficientPermissions
Предоставленный для запроса токен OAuth 2.0 определяет области действия, недостаточные для доступа к запрошенным данным.
notFound (404)
contentOwnerAccountNotFound
Указанная учетная запись владельца контента не найдена.
Request context errors
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
invalidLanguage
Значение параметра hl не указывает допустимый код языка.
badRequest (400)
invalidMine
Использование параметра mine в запросе не поддерживается.
badRequest (400)
invalidMine
Параметр mine нельзя использовать в запросах, где авторизованный пользователь является партнером YouTube. Вам следует либо удалить параметр mine , либо авторизоваться как пользователь YouTube, удалив параметр onBehalfOfContentOwner , либо выступать в роли одного из каналов партнера, указав параметр onBehalfOfContentOwnerChannel если он доступен для вызываемого метода.
badRequest (400)
invalidPart
Параметр part запроса указывает на некоторые части, которые нельзя записывать одновременно.
badRequest (400)
invalidRegionCode
Параметр regionCode указывает недопустимый код региона.
badRequest (400)
unexpectedPart
Параметр part запроса указывает неожиданное значение.
badRequest (400)
unknownPart
Параметр part запроса указывает неизвестное значение.
badRequest (400)
unsupportedLanguageCode
Значение параметра hl не указывает поддерживаемый код языка.
badRequest (400)
unsupportedRegionCode
Параметр regionCode указывает неподдерживаемый код региона.
unauthorized (401)
authorizationRequired
В запросе используется параметр mine , но он не авторизован должным образом.
unauthorized (401)
youtubeSignupRequired
Эта ошибка указывает на то, что у пользователя нет привязанного аккаунта Google, то есть у пользователя есть аккаунт Google , но нет канала YouTube. Такие пользователи могут получить доступ ко многим функциям, зависящим от авторизации пользователя, например, оценивать видео или добавлять видео в плейлист watch_later . Однако, например, для загрузки видео пользователю потребуется канал YouTube. Пользователь, имеющий аккаунт Gmail или устройство Android, наверняка имеет аккаунт Google, но, возможно, еще не привязал этот аккаунт Google к каналу YouTube.
Эта ошибка часто возникает при попытке использовать протокол аутентификации OAuth 2.0 Service Account. YouTube не поддерживает учетные записи служб, и если вы попытаетесь пройти аутентификацию с помощью учетной записи службы, вы получите эту ошибку.
В статье блога YouTube API, посвященной поддержке учетных записей Google, также более подробно обсуждается ошибка youtubeSignupRequired . Хотя в статье объясняется ошибка для версии API 2.1, ее смысл по-прежнему актуален.
activities
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами activities . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
activities.list
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
homeParameterDeprecated
Данные об активности пользователя на главной странице недоступны через этот API. Эта ошибка может возникнуть, если вы установите параметр home в true в неавторизованном запросе.
forbidden (403)
forbidden
Запрос не авторизован должным образом.
notFound (404)
channelNotFound
Идентификатор канала, указанный в параметре channelId запроса, не найден.
notFound (404)
homeChannelNotFound
Для авторизованного пользователя не удается найти ленту на главной странице YouTube.
unauthorized (401)
authorizationRequired
В запросе используется параметр home , но он не авторизован должным образом.
captions
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами captions . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
captions.delete
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
forbidden
Имеющихся для запроса прав недостаточно для удаления субтитров. Возможно, запрос не авторизован должным образом.
notFound (404)
captionNotFound
Не удалось найти дорожку с субтитрами. Проверьте значение параметра id запроса, чтобы убедиться в его корректности.
captions.download
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
forbidden
Имеющихся для запроса прав недостаточно для загрузки субтитров. Возможно, запрос не авторизован должным образом.
invalidValue (400)
couldNotConvert
Не удалось преобразовать данные субтитров в запрошенный язык и/или формат. Убедитесь, что запрошенные значения tfmt и tlang действительны и что snippet.status запрошенных субтитров не имеет failed .
notFound (404)
captionNotFound
Не удалось найти дорожку с субтитрами. Проверьте значение параметра id запроса, чтобы убедиться в его корректности.
captions.insert
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
contentRequired
Запрос не содержит содержимого дорожки субтитров.
conflict (409)
captionExists
Указанное видео уже имеет дорожку субтитров с заданными значениями snippet.language и snippet.name . Видео может иметь несколько дорожек для одного и того же языка, но каждая дорожка должна иметь разное имя.
Существует несколько способов устранения этой ошибки. Вы можете удалить существующую дорожку, а затем вставить новую, или изменить название новой дорожки перед её вставкой.
forbidden (403)
forbidden
Имеющихся для запроса прав недостаточно для загрузки субтитров. Возможно, запрос не авторизован должным образом.
invalidValue (400)
invalidMetadata
Запрос содержит недопустимые значения метаданных, которые препятствуют созданию трека. Убедитесь, что в запросе указаны допустимые значения для свойств snippet.language , snippet.name и snippet.videoId . Свойство snippet.isDraft также может быть включено, но это не обязательно.
notFound (404)
videoNotFound
Видео, идентифицированное параметром videoId , не найдено.
invalidValue (400)
nameTooLong
Указанное в запросе snippet.name слишком длинное. Максимальная поддерживаемая длина составляет 150 символов.
captions.list
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
forbidden
Не удалось получить одну или несколько дорожек субтитров, поскольку связанные с запросом права доступа недостаточны для получения запрошенных ресурсов. Возможно, запрос не был должным образом авторизован.
notFound (404)
captionNotFound
Одна или несколько указанных дорожек субтитров не найдены. Эта ошибка возникает, если параметр videoId идентифицирует реальное видео, а параметр id идентифицирует либо идентификаторы дорожек субтитров, которых не существует, либо идентификаторы дорожек, связанных с другими видео. Проверьте значения параметров id и videoId запроса, чтобы убедиться в их корректности.
notFound (404)
videoNotFound
Видео, идентифицированное параметром videoId , не найдено.
captions.update
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
contentRequired
Запрос не загрузил обновленный файл субтитров. Для корректного sync содержимого трека требуется значение true .
forbidden (403)
forbidden
Имеющихся для запроса прав недостаточно для обновления субтитров. Возможно, запрос не авторизован должным образом.
notFound (404)
captionNotFound
Указанная дорожка субтитров не найдена. Проверьте значение параметра id запроса, чтобы убедиться в его корректности.
channelBanners
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами channelBanners . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
channelBanners.insert
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
bannerAlbumFull
В альбоме «Обложка вашего канала YouTube» слишком много изображений. Пожалуйста, перейдите по ссылке http://photos.google.com , откройте страницу альбомов и удалите несколько изображений из этого альбома.
badRequest (400)
mediaBodyRequired
Запрос не включает в себя содержимое изображения.
channelSections
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами channelSections . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
channelSections.delete
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
notEditable
Этот раздел канала удалить нельзя.
forbidden (403)
channelSectionForbidden
Запрос не прошел надлежащую аутентификацию или не поддерживается для данного канала.
invalidValue (400)
idInvalid
Свойство id указывает недопустимый идентификатор раздела канала.
invalidValue (400)
idRequired
Свойство id должно указывать значение, идентифицирующее удаляемый раздел канала.
notFound (404)
channelNotFound
Канал не найден.
notFound (404)
channelSectionNotFound
Раздел канала, который вы пытаетесь обновить, не найден.
channelSections.insert
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
defaultLanguageNotSetError
Для успешного добавления или обновления объекта localizations для ресурса channelSection необходимо установить свойство snippet.defaultLanguage .
badRequest (400)
invalidLanguage
Один из языковых ключей объекта localizations не прошел проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
notEditable
Создать этот раздел канала невозможно.
badRequest (400)
styleRequired
Ресурс channelSection должен указывать значение для поля snippet.style .
badRequest (400)
targetInvalidCountry
Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
targetInvalidLanguage
Одно из значений в списке targeting.languages не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
targetInvalidRegion
Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
typeRequired
Ресурс channelSection должен указывать значение для поля snippet.type .
forbidden (403)
channelSectionForbidden
Запрос не прошёл надлежащую аутентификацию или не поддерживается для данного канала.
invalidValue (400)
channelNotActive
По крайней мере один из указанных каналов неактивен.
invalidValue (400)
channelsDuplicated
Запрос не удался, поскольку были указаны дублирующиеся каналы.
invalidValue (400)
channelsNeeded
Если свойство snippet.type имеет значение multipleChannels , то необходимо указать свойство contentDetails.channels[] , которое должно содержать как минимум один канал.
invalidValue (400)
channelsNotExpected
В предоставленном запросе ресурсе указано значение свойства contentDetails.channels[] , но наличие каналов для данного типа раздела каналов не ожидается.
invalidValue (400)
contentDetailsNeeded
Для данного типа раздела канала вставляемый ресурс должен содержать объект contentDetails .
invalidValue (400)
inValidPosition
Свойство snippet.position содержит недопустимое значение.
invalidValue (400)
maxChannelSectionExceeded
Запрос не может быть выполнен, поскольку канал уже достиг максимального количества разделов.
invalidValue (400)
maxChannelsExceeded
Запрос не удался, поскольку в раздел каналов было предпринято попытку включить слишком много каналов.
invalidValue (400)
maxPlaylistExceeded
Запрос не удался, поскольку в раздел каналов было предпринято попытку включить слишком много плейлистов.
invalidValue (400)
onePlaylistNeeded
Если свойство snippet.type имеет значение singlePlaylist , то свойство contentDetails.playlists[] должно указывать ровно один плейлист.
invalidValue (400)
ownChannelInChannels
Вы не можете добавить свой собственный канал в раздел канала, который отображается на этом канале.
invalidValue (400)
playlistIsPrivate
Один или несколько указанных плейлистов являются приватными и, следовательно, не могут быть включены в раздел канала.
invalidValue (400)
playlistsDuplicated
Запрос не удался, поскольку в нем были указаны повторяющиеся плейлисты.
invalidValue (400)
playlistsNeeded
Если свойство snippet.type имеет значение singlePlaylist или multiplePlaylists , то необходимо указать свойство contentDetails.playlists[] .
invalidValue (400)
playlistsNotExpected
В предоставленном запросе ресурсе указано значение свойства contentDetails.playlists[] , но наличие плейлистов в этом типе раздела канала не ожидается.
invalidValue (400)
snippetNeeded
Для создания раздела канала необходимо указать snippet .
invalidValue (400)
titleLengthExceeded
Значение свойства snippet.title слишком длинное.
invalidValue (400)
titleRequired
Если свойство snippet.type имеет значение multiplePlaylists или multipleChannels , то заголовок раздела необходимо задать, указав значение свойства snippet.title .
notFound (404)
channelNotFound
Один или несколько указанных каналов не найдены.
notFound (404)
playlistNotFound
Один или несколько указанных плейлистов не найдены.
channelSections.list
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
channelSectionForbidden
Заявителю запрещен доступ к запрошенным разделам канала.
invalidValue (400)
idInvalid
В запросе указан недопустимый идентификатор раздела канала.
invalidValue (400)
invalidCriteria
Запрос не может быть выполнен, поскольку критерии фильтра недействительны.
notFound (404)
channelNotFound
Канал, связанный с запросом, не найден.
notFound (404)
channelSectionNotFound
Раздел канала, связанный с запросом, не найден.
channelSections.update
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
defaultLanguageNotSetError
Для успешного добавления или обновления объекта localizations для ресурса channelSection необходимо установить свойство snippet.defaultLanguage .
badRequest (400)
invalidLanguage
Один из языковых ключей объекта localizations не прошел проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
notEditable
Этот раздел канала нельзя редактировать.
badRequest (400)
styleRequired
Ресурс channelSection должен указывать значение для поля snippet.style .
badRequest (400)
targetInvalidCountry
Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
targetInvalidLanguage
Одно из значений в списке targeting.languages не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
targetInvalidRegion
Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновите их в соответствии с рекомендациями, изложенными в документации ресурса channelSections .
badRequest (400)
typeRequired
Ресурс channelSection должен указывать значение для поля snippet.type .
forbidden (403)
channelSectionForbidden
Запрос не прошёл надлежащую аутентификацию или не поддерживается для данного канала.
invalidValue (400)
channelNotActive
По крайней мере один из указанных каналов неактивен.
invalidValue (400)
channelsDuplicated
Запрос не удался, поскольку были указаны дублирующиеся каналы.
invalidValue (400)
channelsNeeded
Если свойство snippet.type имеет значение multipleChannels , то необходимо указать свойство contentDetails.channels[] , которое должно содержать как минимум один канал.
invalidValue (400)
channelsNotExpected
В предоставленном запросе ресурсе указано значение свойства contentDetails.channels[] , но наличие каналов для данного типа раздела каналов не ожидается.
invalidValue (400)
contentDetailsNeeded
Для данного типа раздела канала обновляемый ресурс должен содержать объект contentDetails .
invalidValue (400)
idInvalid
Свойство id указывает недопустимый идентификатор раздела канала.
invalidValue (400)
idRequired
Свойство id должно указывать значение, идентифицирующее обновляемый раздел канала.
invalidValue (400)
inValidPosition
Свойство snippet.position содержит недопустимое значение.
invalidValue (400)
maxChannelsExceeded
Запрос не удался, поскольку в раздел каналов было предпринято попытку включить слишком много каналов.
invalidValue (400)
maxPlaylistExceeded
Запрос не удался, поскольку в раздел каналов было предпринято попытку включить слишком много плейлистов.
invalidValue (400)
onePlaylistNeeded
Если свойство snippet.type имеет значение singlePlaylist , то свойство contentDetails.playlists[] должно указывать ровно один плейлист.
invalidValue (400)
ownChannelInChannels
Вы не можете добавить свой собственный канал в раздел канала, который отображается на этом канале.
invalidValue (400)
playlistIsPrivate
Один или несколько указанных плейлистов являются приватными и, следовательно, не могут быть включены в раздел канала.
invalidValue (400)
playlistsDuplicated
Запрос не удался, поскольку в нем были указаны повторяющиеся плейлисты.
invalidValue (400)
playlistsNeeded
Если свойство snippet.type имеет значение singlePlaylist или multiplePlaylists , то необходимо указать свойство contentDetails.playlists[] .
invalidValue (400)
playlistsNotExpected
В предоставленном запросе ресурсе указано значение свойства contentDetails.playlists[] , но наличие плейлистов в этом типе раздела канала не ожидается.
invalidValue (400)
snippetNeeded
Для обновления раздела канала необходимо указать snippet .
invalidValue (400)
titleLengthExceeded
Значение свойства snippet.title слишком длинное.
invalidValue (400)
titleRequired
Если свойство snippet.type имеет значение multiplePlaylists или multipleChannels , то заголовок раздела необходимо задать, указав значение свойства snippet.title .
notFound (404)
channelNotFound
Один или несколько указанных каналов не найдены.
notFound (404)
channelSectionNotFound
Раздел канала, который вы пытаетесь обновить, не найден.
notFound (404)
playlistNotFound
Один или несколько указанных плейлистов не найдены.
channels
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами channels . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
channels.list
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
invalidCriteria
Можно указать максимум один из следующих фильтров: id , mySubscribers , categoryId , mine , managedByMe , forUsername . В случае аутентификации владельца контента с использованием параметра onBehalfOfContentOwner можно указать только id или managedByMe .
forbidden (403)
channelForbidden
Канал, указанный параметром id , не поддерживает запрос или запрос не авторизован должным образом.
notFound (404)
categoryNotFound
Категория, указанная параметром categoryId , не найдена.
notFound (404)
channelNotFound
Канал, указанный в параметре id не найден.
channels.update
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
brandingValidationError
Одно из значений в объекте brandingSettings не прошло проверку. Используйте метод channels.list для получения существующих настроек канала и обновите значения свойств в соответствии с рекомендациями, изложенными в документации по ресурсу channels .
badRequest (400)
channelTitleUpdateForbidden
При обновлении brandingSettings part канала необходимо установить значение свойства brandingSettings.channel.title равным текущему названию канала или опустить это свойство. API вернет ошибку, если вы измените значение свойства.
badRequest (400)
defaultLanguageNotSetError
Для обновления localizations необходимо установить defaultLanguage .
badRequest (400)
invalidBrandingOption
Один из указанных вами параметров брендинга отсутствует. Используйте метод channels.list для получения допустимых значений и обязательно обновите их в соответствии с рекомендациями, изложенными в документации по ресурсам channels .
badRequest (400)
invalidCustomMessage
Метаданные запроса указывают на недопустимое пользовательское сообщение. Проверьте значение свойства invideoPromotion.items[].customMessage в ресурсе, который был отправлен запросом.
badRequest (400)
invalidDuration
В метаданных запроса в части invideoPromotion указана недопустимая продолжительность.
badRequest (400)
invalidDuration
Метаданные запроса указывают недопустимый тип позиционирования для определения того, как рекламируемый элемент располагается в видеоплеере. Проверьте значение свойства invideoPromotion.position.type в ресурсе, отправленном запросом.
В метаданных запроса в части invideoPromotion указывается недопустимое смещение по времени.
badRequest (400)
invalidTimingOffset
Метаданные запроса указывают недопустимое смещение по времени для определения момента отображения рекламируемого элемента в видеоплеере. Проверьте значение свойства invideoPromotion.timing.offsetMs в ресурсе, отправленном запросом.
badRequest (400)
invalidTimingType
Метаданные запроса указывают на недопустимый метод определения момента отображения рекламируемого элемента в видеоплеере. Проверьте значение свойства invideoPromotion.timing.type в ресурсе, отправленном запросом.
badRequest (400)
localizationValidationError
Одно из значений в объекте localizations не прошло проверку. Используйте метод channels.list для получения допустимых значений и обязательно обновляйте их в соответствии с рекомендациями, изложенными в документации ресурса channels.
badRequest (400)
tooManyPromotedItems
В разделе invideoPromotion превышено количество разрешенных рекламируемых товаров.
forbidden (403)
channelForbidden
Канал, указанный в параметре id , не поддерживает запрос или запрос не авторизован должным образом.
forbidden (403)
promotedVideoNotAllowed
Канал, который пытается обновить API-запрос, не найден. Проверьте значение свойства id в ресурсе channel , отправленном запросом, чтобы убедиться в правильности идентификатора канала.
forbidden (403)
websiteLinkNotAllowed
Указанный URL-адрес веб-сайта недопустим.
notFound (404)
channelNotFound
Канал, указанный параметром id , не найден или не имеет параметров брендинга.
notFound (404)
channelNotFound
Канал, указанный в параметре id не найден.
notFound (404)
unknownChannelId
Указанный идентификатор канала не найден.
notFound (404)
unknownChannelId
Указанный идентификатор канала recentlyUploadedBy не найден.
В метаданных запроса в части invideoPromotion должен быть указан тип элемента.
required (400)
requiredItemId
В метаданных запроса необходимо указать элемент в части invideoPromotion.
required (400)
requiredTimingOffset
В метаданных запроса необходимо указать смещение по умолчанию по времени, чтобы YouTube мог определить, когда показывать рекламируемый контент. Установите значение свойства invideoPromotion.defaultTiming.offsetMs в ресурсе, который отправляет запрос.
required (400)
requiredTimingOffset
В метаданных запроса необходимо указать смещение по времени, чтобы YouTube мог определить, когда следует отображать рекламируемый контент. Установите значение свойства invideoPromotion.timing.offsetMs в ресурсе, который отправляет запрос.
required (400)
requiredTimingType
Метаданные запроса должны указывать метод синхронизации, чтобы YouTube мог определить, когда следует показывать рекламируемый контент. Установите значение свойства invideoPromotion.defaultTiming.type в ресурсе, который отправляет запрос.
required (400)
requiredTimingType
Метаданные запроса должны указывать метод синхронизации, чтобы YouTube мог определить, когда следует показывать рекламируемый контент. Установите значение свойства invideoPromotion.timing.type в ресурсе, который отправляет запрос.
required (400)
requiredTiming
В метаданных запроса необходимо указать время для каждого элемента в части invideoPromotion .
required (400)
requiredVideoId
В метаданных запроса необходимо указать идентификатор видео для идентификации рекламируемого товара.
required (400)
requiredWebsiteUrl
В метаданных запроса необходимо указать URL-адрес веб-сайта в части invideoPromotion. Установите значение свойства invideoPromotion.items[].id.websiteUrl в ресурсе, который отправляет запрос.
commentThreads
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами commentThreads . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
commentThreads.list
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
operationNotSupported
API-запрос недействителен или неправильно сформирован. Следовательно, API-сервер не смог обработать запрос.
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимость входных данных запроса. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться в его корректности.
forbidden (403)
commentsDisabled
Для видео, идентифицированного параметром videoId , комментарии отключены.
forbidden (403)
forbidden
Не удается получить доступ к одной или нескольким запрошенным веткам комментариев из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
Не удалось найти одну или несколько указанных веток комментариев. Проверьте правильность значений параметра id запроса.
notFound (404)
videoNotFound
Видео, идентифицированное параметром videoId , не найдено.
commentThreads.insert
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
channelOrVideoIdMissing
Каждая ветка комментариев должна быть связана с каналом или видео. Убедитесь, что ресурс указывает значения для свойств snippet.channelId и snippet.videoId . Комментарий к видео отображается на странице просмотра видео.
badRequest (400)
commentTextRequired
Вставляемый comment должен указывать значение свойства snippet.topLevelComment.snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400)
commentTextTooLong
Вставляемый comment содержит слишком много символов в свойстве snippet.topLevelComment.snippet.textOriginal .
badRequest (400)
invalidCommentThreadMetadata
Метаданные запроса недействительны.
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимость входных данных запроса. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться в его корректности.
forbidden (403)
forbidden
Возможно, ветка комментариев была создана из-за недостаточных прав доступа. Запрос мог быть некорректно авторизован.
forbidden (403)
ineligibleAccount
Для добавления комментария или ветки комментариев учетная запись YouTube, используемая для авторизации запроса к API, должна быть объединена с учетной записью Google пользователя.
notFound (404)
channelNotFound
Указанный канал не найден. Проверьте правильность значения свойства snippet.channelId .
notFound (404)
videoNotFound
Указанное видео не найдено. Проверьте правильность значения свойства snippet.videoId .
comments
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами comments . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
comments.list
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
operationNotSupported
API-запрос недействителен или неправильно сформирован. Следовательно, API-сервер не смог обработать запрос.
forbidden (403)
forbidden
Один или несколько запрошенных комментариев не могут быть получены из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
notFound (404)
commentNotFound
Один или несколько указанных комментариев не найдены. Проверьте правильность значений параметров id и parentId запроса.
comments.setModerationStatus
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
banWithoutReject
Параметр banAuthor можно использовать только в том случае, если значение параметра moderationStatusrejected .
badRequest (400)
operationNotSupported
API-запрос недействителен или неправильно сформирован. Следовательно, API-сервер не смог обработать запрос.
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимые входные данные запроса.
forbidden (403)
forbidden
Из-за недостаточных прав доступа невозможно установить статус модерации для одного или нескольких комментариев. Возможно, запрос не авторизован должным образом.
notFound (404)
commentNotFound
Один или несколько комментариев, которые запрашивается для обновления, не найдены. Проверьте значения параметра id запроса, чтобы убедиться в их корректности.
comments.insert
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
commentTextRequired
Вставляемый comment должен указывать значение свойства snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400)
commentTextTooLong
Вставляемый comment содержит слишком много символов в свойстве snippet.textOriginal .
badRequest (400)
invalidCommentMetadata
Метаданные запроса недействительны.
badRequest (400)
operationNotSupported
Пользователь API не может вставить комментарий в ответ на комментарий верхнего уровня, идентифицированный свойством snippet.parentId . В ресурсе commentThread свойство snippet.canReply указывает, может ли текущий пользователь отвечать на ветку обсуждения.
badRequest (400)
parentCommentIsPrivate
Указанный родительский комментарий является приватным. API не поддерживает ответы на приватные комментарии.
badRequest (400)
parentIdMissing
Вставляемый комментарий должен быть связан с родительским комментарием. Однако в теле API-запроса для ресурса comment не указано значение свойства snippet.parentId .
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимость входных данных запроса. Проверьте структуру ресурса comment в теле запроса, чтобы убедиться в его корректности.
forbidden (403)
forbidden
Невозможно создать комментарий из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
forbidden (403)
ineligibleAccount
Для добавления комментария или ветки комментариев учетная запись YouTube, используемая для авторизации запроса к API, должна быть объединена с учетной записью Google пользователя.
notFound (404)
parentCommentNotFound
Указанный родительский комментарий не найден. Проверьте значение свойства snippet.parentId в теле запроса, чтобы убедиться в его корректности.
comments.delete
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимые входные данные запроса.
forbidden (403)
forbidden
Комментарий не удалось удалить из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
notFound (404)
commentNotFound
Указанный комментарий не найден. Проверьте значение параметра id запроса, чтобы убедиться в его корректности.
comments.update
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
commentTextTooLong
В обновляемом comment содержится слишком много символов в свойстве snippet.textOriginal .
badRequest (400)
invalidCommentMetadata
Метаданные запроса недействительны.
badRequest (400)
operationNotSupported
API-запрос недействителен или неправильно сформирован. Следовательно, API-сервер не смог обработать запрос.
badRequest (400)
processingFailure
Сервер API не смог успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на недопустимость входных данных запроса. Проверьте структуру ресурса comment в теле запроса, чтобы убедиться в его корректности.
forbidden (403)
forbidden
Не удалось обновить комментарий из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
forbidden (403)
ineligibleAccount
Для обновления комментария или ветки комментариев учетная запись YouTube, используемая для авторизации запроса к API, должна быть объединена с учетной записью Google пользователя.
notFound (404)
commentNotFound
Указанный комментарий не найден. Проверьте значение свойства id в теле запроса, чтобы убедиться в его корректности.
members
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами members . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
members.list
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
channelMembershipsNotEnabled
У канала автора, подтвердившего запрос, не включена функция членства в канале.
badRequest (400)
invalidMode
Значение параметра mode недопустимо. Эта ошибка может возникнуть, если параметр pageToken указывает токен, полученный с использованием другого режима, отличного от указанного.
badRequest (400)
invalidPageToken
Значение параметра pageToken недопустимо. Эта ошибка возникает, если срок действия токена страницы, использованного в запросе, истек.
badRequest (400)
invalidHasAccessToLevel
Значение параметра hasAccessToLevel недопустимо. Уровень с указанным id отсутствует.
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами members . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
membershipsLevels.list
Тип ошибки
Подробности ошибки
Описание
badRequest (400)
channelMembershipsNotEnabled
У канала автора, подтвердившего запрос, не включена функция членства в канале.
playlistItems
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами playlistItems . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .
playlistItems.delete
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
playlistItemsNotAccessible
Запрос на удаление указанного элемента плейлиста не авторизован должным образом.
notFound (404)
playlistItemNotFound
Элемент плейлиста, указанный в параметре id запроса, не найден.
invalidValue (400)
playlistOperationUnsupported
API не поддерживает возможность удаления видео из указанного плейлиста. Например, вы не можете удалить видео из плейлиста загруженных вами видео.
playlistItems.insert
Тип ошибки
Подробности ошибки
Описание
duplicate
videoAlreadyInPlaylist
Видео, которое вы пытаетесь добавить в плейлист, уже есть в плейлисте.
forbidden (403)
playlistContainsMaximumNumberOfVideos
Плейлист уже содержит максимально допустимое количество элементов.
forbidden (403)
playlistItemsNotAccessible
Запрос на вставку указанного элемента плейлиста не авторизован должным образом.
invalidValue (400)
invalidContentDetails
Свойство contentDetails в запросе недопустимо. Возможная причина — поле contentDetails.note длиннее 280 символов.
invalidValue (400)
invalidPlaylistItemPosition
Запрос пытается установить позицию элемента плейлиста на недопустимое или неподдерживаемое значение. Проверьте значение свойства position в snippet кода ресурса.
invalidValue (400)
invalidResourceType
type , указанный для идентификатора ресурса, не поддерживается для этой операции. Идентификатор ресурса идентифицирует элемент, добавляемый в плейлист, например, youtube#video .
invalidValue (400)
manualSortRequired
Запрос пытается установить позицию элемента плейлиста, но плейлист не использует ручную сортировку. (Например, элементы плейлиста могут быть отсортированы по дате или популярности.) Вы можете исправить ошибку, удалив элемент snippet.position из ресурса, который вставляет запрос. Если вы хотите, чтобы элемент плейлиста занимал определенную позицию в списке, вам необходимо сначала изменить параметр « Порядок сортировки» плейлиста на «Вручную» в его настройках. Эти настройки можно изменить в менеджере видео YouTube .
invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
Видео, которое вы пытаетесь добавить в плейлист, уже находится в другом плейлисте с сериалами.
invalidValue (400)
playlistOperationUnsupported
API не поддерживает возможность вставки видео в указанный плейлист. Например, вы не можете вставить видео в плейлист загруженных вами видео.
notFound (404)
playlistNotFound
Плейлист, указанный в параметре playlistId запроса, не найден.
notFound (404)
videoNotFound
Видео, которое вы пытаетесь добавить в плейлист, не найдено. Проверьте значение свойства videoId , чтобы убедиться в его корректности.
required (400)
channelIdRequired
В запросе не указано значение для обязательного свойства channelId .
required (400)
playlistIdRequired
В запросе не указано значение для обязательного свойства playlistId .
required (400)
resourceIdRequired
Запрос должен содержать ресурс, в котором объект snippet указывает resourceId .
playlistItems.list
Тип ошибки
Подробности ошибки
Описание
forbidden (403)
playlistItemsNotAccessible
Запрос на получение указанного плейлиста не авторизован должным образом.
notFound (404)
playlistNotFound
The playlist identified with the request's playlistId parameter cannot be found.
notFound (404)
videoNotFound
The video identified with the request's videoId parameter cannot be found.
required (400)
playlistIdRequired
The subscribe request does not specify a value for the required playlistId property.
invalidValue (400)
playlistOperationUnsupported
The API does not support the ability to list videos in the specified playlist. For example, you can't list a video in your watch later playlist.
playlistItems.update
Error type
Error detail
Описание
forbidden (403)
playlistItemsNotAccessible
The request is not properly authorized to update the specified playlist item.
invalidValue (400)
invalidPlaylistItemPosition
The request attempts to set the playlist item's position to an invalid or unsupported value. Check the value of the position property in the resource's snippet .
invalidValue (400)
invalidResourceType
The type specified for the resource ID is not supported for this operation. The resource ID identifies the item being added to the playlist – such as youtube#video .
invalidValue (400)
invalidSnippet
The request does not specify a valid snippet property.
invalidValue (400)
manualSortRequired
The request attempts to set the playlist item's position, but the playlist does not use manual sorting. (For example, playlist items might be sorted by date or popularity.) You can address the error by removing the snippet.position element from the resource that the request is inserting. If you want the playlist item to have a particular position in the list, you need to first update the playlist's Ordering option to Manual in the playlist's settings. This settings can be adjusted in the YouTube Video Manager .
invalidValue (400)
playlistOperationUnsupported
The API does not support the ability to update videos in the specified playlist. For example, you can't update a video in your uploaded videos playlist.
notFound (404)
playlistItemNotFound
The playlist item identified with the request's id property cannot be found.
notFound (404)
playlistNotFound
The playlist identified with the request's playlistId parameter cannot be found.
required (400)
channelIdRequired
The request does not specify a value for the required channelId property.
required (400)
playlistIdRequired
The request does not specify a value for the required playlistId property.
required (400)
playlistItemIdRequired
The playlist item resource specified in the request must use the id property to identify the playlist item that is being updated.
playlists
The following tables identify error messages that the API returns in response to calls related to playlists resources. These methods could also return errors listed in the Common request errors section.
playlists.delete
Error type
Error detail
Описание
forbidden (403)
playlistForbidden
This operation is forbidden or the request is not properly authorized.
notFound (404)
playlistNotFound
The playlist identified with the request's id parameter cannot be found.
invalidValue (400)
playlistOperationUnsupported
The API does not support the ability to delete the specified playlist. For example, you can't delete your uploaded videos playlist.
playlists.list
Error type
Error detail
Описание
forbidden (403)
channelClosed
The channel specified in the channelId parameter has been closed.
forbidden (403)
channelSuspended
The channel specified in the channelId parameter has been suspended.
forbidden (403)
playlistForbidden
The playlist identified with the request's id parameter does not support the request or the request is not properly authorized.
notFound (404)
channelNotFound
The channel specified in the channelId parameter cannot be found.
notFound (404)
playlistNotFound
The playlist identified with the request's id parameter cannot be found.
invalidValue (400)
playlistOperationUnsupported
The API does not support the ability to list the specified playlist. For example, you can't list your watch later playlist.
playlists.insert
Error type
Error detail
Описание
badRequest (400)
defaultLanguageNotSetError
The defaultLanguage must be set to update localizations .
badRequest (400)
localizationValidationError
One of the values in the localizations object failed validation. Use the playlists.list method to retrieve valid values and make sure to update them following the guidelines in the playlists resource documentation.
badRequest (400)
maxPlaylistExceeded
The playlist cannot be created because the channel already has the maximum number of playlists allowed.
forbidden (403)
playlistForbidden
This operation is forbidden or the request is not properly authorized.
invalidValue (400)
invalidPlaylistSnippet
The request provides an invalid playlist snippet.
required (400)
playlistTitleRequired
The request must specify a playlist title.
playlists.update
Error type
Error detail
Описание
badRequest (400)
defaultLanguageNotSetError
The defaultLanguage must be set to update localizations .
badRequest (400)
localizationValidationError
One of the values in the localizations object failed validation. Use the playlists.list method to retrieve valid values and make sure to update them following the guidelines in the playlists resource documentation.
forbidden (403)
playlistForbidden
This operation is forbidden or the request is not properly authorized.
invalidValue (400)
invalidPlaylistSnippet
The request provides an invalid playlist snippet.
invalidValue (400)
playlistOperationUnsupported
The API does not support the ability to update the specified playlist. For example, you can't update the properties of your uploaded videos playlist.
notFound (404)
playlistNotFound
The playlist identified with the request's id parameter cannot be found.
required (400)
playlistTitleRequired
The request must specify a playlist title.
search
The following tables identify error messages that the API returns in response to calls related to search resources. These methods could also return errors listed in the Common request errors section.
search.list
Error type
Error detail
Описание
badRequest (400)
invalidChannelId
The channelId parameter specified an invalid channel ID.
badRequest (400)
invalidLocation
The location and/or locationRadius parameter value was formatted incorrectly.
badRequest (400)
invalidRelevanceLanguage
The relevanceLanguage parameter value was formatted incorrectly.
badRequest (400)
invalidSearchFilter
The request contains an invalid combination of search filters and/or restrictions. You must set the type parameter to video if you set a value for the eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated , or videoType parameters.
subscriptions
The following tables identify error messages that the API returns in response to calls related to subscriptions resources. These methods could also return errors listed in the Common request errors section.
subscriptions.delete
Error type
Error detail
Описание
forbidden (403)
subscriptionForbidden
The request is not properly authenticated or not supported for this channel.
notFound (404)
subscriptionNotFound
The subscription that you are trying to delete cannot be found. Check the value of the request's id parameter to ensure that it is correct.
subscriptions.insert
Error type
Error detail
Описание
badRequest (400)
subscriptionDuplicate
The subscription that you are trying to create already exists.
badRequest (400)
subscriptionForbidden
You have reached your maximum number of subscriptions.
badRequest (400)
subscriptionForbidden
Too many recent subscriptions. Please try again in a few hours.
badRequest (400)
subscriptionForbidden
Subscribing to your own channel is not supported.
forbidden (403)
subscriptionForbidden
The request is not properly authenticated or not supported for this channel.
notFound (404)
publisherNotFound
The resource specified by the request's snippet.resourceId property cannot be found.
notFound (404)
subscriberNotFound
The subscriber identified with the request cannot be found.
required (400)
publisherRequired
The subscription resource specified in the request must use the snippet.resourceId property to identify the channel that is being subscribed to.
subscriptions.list
Error type
Error detail
Описание
forbidden (403)
accountClosed
Subscriptions couldn't be retrieved because the subscriber's account is closed.
forbidden (403)
accountSuspended
Subscriptions couldn't be retrieved because the subscriber's account is suspended.
forbidden (403)
subscriptionForbidden
The requester isn't allowed to access the requested subscriptions.
notFound (404)
subscriberNotFound
The subscriber identified with the request cannot be found.
thumbnails
The following tables identify error messages that the API returns in response to calls related to thumbnails resources. These methods could also return errors listed in the Common request errors section.
thumbnails.set
Error type
Error detail
Описание
badRequest (400)
invalidImage
The provided image content is invalid.
badRequest (400)
mediaBodyRequired
The request does not include the image content.
forbidden (403)
forbidden
The thumbnail can't be set for the specified video. The request might not be properly authorized.
forbidden (403)
forbidden
The authenticated user doesn't have permissions to upload and set custom video thumbnails.
notFound (404)
videoNotFound
The video that you are trying to insert a thumbnail image for cannot be found. Check the value of the request's videoId parameter to ensure that it is correct.
tooManyRequests (429)
uploadRateLimitExceeded
The channel has uploaded too many thumbnails recently. Please try the request again later.
videoAbuseReportReasons
The following tables identify error messages that the API returns in response to calls related to videoAbuseReportReasons resources. These methods could also return errors listed in the Common request errors section.
videoAbuseReportReasons.list
Error type
Error detail
Описание
forbidden (403)
forbidden
Access forbidden. The request may not be properly authorized.
videoCategories
The following tables identify error messages that the API returns in response to calls related to videoCategories resources. These methods could also return errors listed in the Common request errors section.
videoCategories.list
Error type
Error detail
Описание
notFound (404)
videoCategoryNotFound
The video category identified by the id parameter cannot be found. Use the videoCategories.list method to retrieve a list of valid values.
videos
The following tables identify error messages that the API returns in response to calls related to videos resources. These methods could also return errors listed in the Common request errors section.
videos.insert
Error type
Error detail
Описание
badRequest (400)
defaultLanguageNotSet
The request is trying to add localized video details without specifying the default language of the video details.
badRequest (400)
invalidCategoryId
The snippet.categoryId property specifies an invalid category ID. Use the videoCategories.list method to retrieve supported categories.
badRequest (400)
invalidDescription
The request metadata specifies an invalid video description.
badRequest (400)
invalidFilename
The video filename specified in the Slug header is invalid.
badRequest (400)
invalidPublishAt
The request metadata specifies an invalid scheduled publishing time.
badRequest (400)
invalidRecordingDetails
The recordingDetails object in the request metadata specifies invalid recording details.
badRequest (400)
invalidTags
The request metadata specifies invalid video keywords.
badRequest (400)
invalidTitle
The request metadata specifies an invalid or empty video title.
badRequest (400)
invalidVideoGameRating
The request metadata specifies an invalid video game rating.
badRequest (400)
invalidVideoMetadata
The request metadata is invalid. This error occurs if the request updates the snippet part of a video resource but does not set a value for both the snippet.title and snippet.categoryId properties.
badRequest (400)
mediaBodyRequired
The request does not include the video content.
badRequest (400)
uploadLimitExceeded
The user has exceeded the number of videos they may upload.
forbidden (403)
forbidden
forbidden (403)
forbiddenLicenseSetting
The request attempts to set an invalid license for the video.
forbidden (403)
forbiddenPrivacySetting
The request attempts to set an invalid privacy setting for the video.
videos.list
Error type
Error detail
Описание
badRequest (400)
videoChartNotFound
The requested video chart is not supported or is not available.
forbidden (403)
forbidden
The request is not properly authorized to access video file or processing information. The fileDetails , processingDetails , and suggestions parts are only available to that video's owner.
forbidden (403)
forbidden
The request cannot access user rating information. This error may occur because the request is not properly authorized to use the myRating parameter.
notFound (404)
videoNotFound
The video that you are trying to retrieve cannot be found. Check the value of the request's id parameter to ensure that it is correct.
videos.delete
Error type
Error detail
Описание
forbidden (403)
forbidden
The video that you are trying to delete cannot be deleted. The request might not be properly authorized.
notFound (404)
videoNotFound
The video that you are trying to delete cannot be found. Check the value of the request's id parameter to ensure that it is correct.
videos.update
Error type
Error detail
Описание
badRequest (400)
defaultLanguageNotSet
The API request is trying to add localized video details without specifying the default language of the video details.
badRequest (400)
invalidCategoryId
The snippet.categoryId property specifies an invalid category ID. Use the videoCategories.list method to retrieve supported categories.
badRequest (400)
invalidDefaultBroadcastPrivacySetting
The request attempts to set an invalid privacy setting for the default broadcast.
badRequest (400)
invalidDescription
The request metadata specifies an invalid video description.
badRequest (400)
invalidPublishAt
The request metadata specifies an invalid scheduled publishing time.
badRequest (400)
invalidRecordingDetails
The recordingDetails object in the request metadata specifies invalid recording details.
badRequest (400)
invalidTags
The request metadata specifies invalid video keywords.
badRequest (400)
invalidTitle
The request metadata specifies an invalid or empty video title.
badRequest (400)
invalidVideoMetadata
The request metadata is invalid. This error occurs if the request updates the snippet part of a video resource but does not set a value for both the snippet.title and snippet.categoryId properties.
forbidden (403)
forbidden
Access forbidden. The request may not be properly authorized.
forbidden (403)
forbiddenEmbedSetting
The request attempts to set an invalid embed setting for the video. Some channels might not have permission to offer embedded players for live streams. See the YouTube Help Center for more information.
forbidden (403)
forbiddenLicenseSetting
The request attempts to set an invalid license for the video.
forbidden (403)
forbiddenPrivacySetting
The request attempts to set an invalid privacy setting for the video.
notFound (404)
videoNotFound
The video that you are trying to update cannot be found. Check the value of the id field in the request body to ensure that it is correct.
videos.rate
Error type
Error detail
Описание
badRequest (400)
emailNotVerified
The user must verify their email address prior to rating.
badRequest (400)
invalidRating
The request contained an unexpected value for the rating parameter.
badRequest (400)
videoPurchaseRequired
Rental videos can only be rated by users who rented them.
forbidden (403)
forbidden
The video that you are trying to rate cannot be rated. The request might not be properly authorized.
forbidden (403)
videoRatingDisabled
The owner of the video that you are trying to rate has disabled ratings for that video.
notFound (404)
videoNotFound
The video that you are trying to rate cannot be found. Check the value of the request's id parameter to ensure that it is correct.
videos.reportAbuse
Error type
Error detail
Описание
badRequest (400)
invalidAbuseReason
The request contained an unexpected value for the reason_id field, or a combination of the reason_id and secondary_reason_id fields.
badRequest (400)
rateLimitExceeded
The user has sent too many requests in a given timeframe.
forbidden (403)
forbidden
notFound (404)
videoNotFound
The video that you are trying to report abuse for cannot be found.
watermarks
The following tables identify error messages that the API returns in response to calls related to watermarks resources. These methods could also return errors listed in the Common request errors section.
watermarks.set
Error type
Error detail
Описание
badRequest (400)
imageFormatUnsupported
The image you provided is in an unsupported format.
badRequest (400)
imageTooTall
The image you provided is too tall.
badRequest (400)
imageTooWide
The image you provided is too wide.
badRequest (400)
mediaBodyRequired
The request does not include the image content.
forbidden (403)
forbidden
The watermark can't be set for the specified channel. The request may not be properly authorized, or the channelId parameter is set to an invalid value.
watermarks.unset
Error type
Error detail
Описание
forbidden (403)
forbidden
The watermark can't be unset for the specified channel. The request may not be properly authorized, or the channelId parameter is set to an invalid value.
[[["Прост для понимания","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"]],["Последнее обновление: 2026-03-13 UTC."],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
comments
В приведенных ниже таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами
comments. Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запросов» .comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidиparentIdзапроса.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthorможно использовать только в том случае, если значение параметраmoderationStatusrejected.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidзапроса, чтобы убедиться в их корректности.comments.insertbadRequest (400)commentTextRequiredcommentдолжен указывать значение свойстваsnippet.textOriginal. Комментарии не могут быть пустыми.badRequest (400)commentTextTooLongcommentсодержит слишком много символов в свойствеsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentId. В ресурсеcommentThreadсвойствоsnippet.canReplyуказывает, может ли текущий пользователь отвечать на ветку обсуждения.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentне указано значение свойстваsnippet.parentId.badRequest (400)processingFailurecommentв теле запроса, чтобы убедиться в его корректности.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdв теле запроса, чтобы убедиться в его корректности.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidзапроса, чтобы убедиться в его корректности.comments.updatebadRequest (400)commentTextTooLongcommentсодержится слишком много символов в свойствеsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentв теле запроса, чтобы убедиться в его корректности.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidв теле запроса, чтобы убедиться в его корректности.