Эта страница переведена с помощью Cloud Translation API.

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` в ресурсе, отправленном запросом.
`badRequest (400)`	`invalidRecentlyUploadedBy`	В метаданных запроса указан недопустимый идентификатор канала. Проверьте значение свойства `invideoPromotion.items[].id.recentlyUploadedBy` в ресурсе, отправленном запросом.
`badRequest (400)`	`invalidTimingOffset`	В метаданных запроса в части 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 не найден.
`notFound (404)`	`unknownVideoId`	Видеофайл с указанным идентификатором , указанный как рекламируемый товар, не найден.
`required (400)`	`requiredItemIdType`	В метаданных запроса в части 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`	Не удается получить доступ к одной или нескольким запрошенным веткам комментариев из-за недостаточных прав доступа. Возможно, запрос не авторизован должным образом.
`notFound (404)`	`channelNotFound`	Канал, указанный параметром `allThreadsRelatedToChannelId` , не найден.
`notFound (404)`	`commentThreadNotFound`	Не удалось найти одну или несколько указанных веток комментариев. Проверьте правильность значений параметра `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` можно использовать только в том случае, если значение параметра `moderationStatus` `rejected` .
`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` отсутствует.
`badRequest (400)`	`invalidFilterByMemberChannelId`	Недопустимое значение параметра `filterByMemberChannelId` . Эта ошибка возникает, если значение параметра `filterByMemberChannelId` указывает более 100 каналов.

membershipsLevels

`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.

YouTube Data API - Errors Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Общие ошибки

Core API errors

Common request errors

Request context errors

activities

activities.list

captions

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

channels

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

comments

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update