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, но он может быть ещё не привязан к каналу YouTube.

Эта ошибка обычно возникает при попытке использовать протокол OAuth 2.0 Service Account. YouTube не поддерживает Service Accounts, и если вы попытаетесь пройти аутентификацию с помощью Service Account, вы получите эту ошибку.

В записи блога YouTube API, посвящённой поддержке учётных записей Google, ошибка youtubeSignupRequired также обсуждается более подробно. Хотя в записи блога ошибка описана для версии API 2.1, её значение остаётся неизменным.

activities

В следующих таблицах представлены сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами activities . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространённые ошибки запросов» .

activities.list

Тип ошибки Подробности ошибки Описание
forbidden (403) homeParameterDeprecated Данные об активности пользователя на домашней странице недоступны через этот API. Эта ошибка может возникнуть, если вы установили значение true для параметра home в неавторизованном запросе.
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 для этого ресурса необходимо настроить свойство snippet.defaultLanguage ресурса channelSection .
badRequest (400) invalidLanguage Один из языковых ключей объекта localizations не прошёл проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями в документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) notEditable Этот раздел канала не может быть создан.
badRequest (400) styleRequired Ресурс channelSection должен указывать значение для поля snippet.style .
badRequest (400) targetInvalidCountry Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями в документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) targetInvalidLanguage Одно из значений в списке targeting.languages ​​не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями из документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) targetInvalidRegion Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями из документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">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 для этого ресурса необходимо настроить свойство snippet.defaultLanguage ресурса channelSection .
badRequest (400) invalidLanguage Один из языковых ключей объекта localizations не прошёл проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями в документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) notEditable Этот раздел канала не может быть отредактирован.
badRequest (400) styleRequired Ресурс channelSection должен указывать значение для поля snippet.style .
badRequest (400) targetInvalidCountry Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями в документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) targetInvalidLanguage Одно из значений в списке targeting.languages ​​не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями из документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">channelSections .
badRequest (400) targetInvalidRegion Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list для получения допустимых значений и обновления их в соответствии с инструкциями из документации по ресурсу a href="/youtube/v3/docs/channelSections#resource">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 для получения допустимых значений и обязательно обновите их, следуя инструкциям в документации по ресурсам каналов.
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 может использоваться только в том случае, если значение параметра 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 Вставляемый комментарий должен быть связан с родительским комментарием. Однако ресурс comment в теле запроса API не указал значение свойства 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

В следующих таблицах представлены сообщения об ошибках, которые 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 Невозможно найти плейлист, идентифицированный параметром playlistId запроса.
notFound (404) videoNotFound Видео, идентифицированное параметром videoId запроса, не найдено.
required (400) playlistIdRequired В запросе на подписку не указано значение обязательного свойства playlistId .
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность включения видео в указанный плейлист. Например, вы не можете добавить видео в плейлист «Посмотреть позже».

playlistItems.update

Тип ошибки Подробности ошибки Описание
forbidden (403) playlistItemsNotAccessible Запрос не авторизован должным образом для обновления указанного элемента списка воспроизведения.
invalidValue (400) invalidPlaylistItemPosition Запрос пытается установить для позиции элемента списка воспроизведения недопустимое или неподдерживаемое значение. Проверьте значение свойства position во snippet ресурса.
invalidValue (400) invalidResourceType type указанный для идентификатора ресурса, не поддерживается для этой операции. Идентификатор ресурса идентифицирует элемент, добавляемый в список воспроизведения, например youtube#video .
invalidValue (400) invalidSnippet В запросе не указано допустимое свойство snippet .
invalidValue (400) manualSortRequired Запрос пытается установить положение элемента списка воспроизведения, но список воспроизведения не использует ручную сортировку. (Например, элементы плейлиста могут быть отсортированы по дате или популярности.) Эту ошибку можно устранить, удалив элемент snippet.position из ресурса, вставляемого запросом. Если вы хотите, чтобы элемент списка воспроизведения занимал определенную позицию в списке, вам необходимо сначала обновить параметр «Упорядочение» списка воспроизведения на «Вручную» в настройках списка воспроизведения. Эти настройки можно изменить в Менеджере видео YouTube .
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность обновления видео в указанном плейлисте. Например, вы не можете обновить видео в плейлисте загруженных видео.
notFound (404) playlistItemNotFound Элемент списка воспроизведения, определенный свойством id запроса, не найден.
notFound (404) playlistNotFound Список воспроизведения, указанный в параметре playlistId запроса, не найден.
required (400) channelIdRequired В запросе не указано значение обязательного свойства channelId .
required (400) playlistIdRequired В запросе не указано значение обязательного свойства playlistId .
required (400) playlistItemIdRequired Ресурс элемента списка воспроизведения, указанный в запросе, должен использовать свойство id для идентификации обновляемого элемента списка воспроизведения.

playlists

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами playlists . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

playlists.delete

Тип ошибки Подробности ошибки Описание
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован должным образом.
notFound (404) playlistNotFound Невозможно найти список воспроизведения, указанный в параметре id запроса.
invalidValue (400) playlistOperationUnsupported API не поддерживает удаление указанного плейлиста. Например, вы не можете удалить плейлист с загруженными вами видео.

playlists.list

Тип ошибки Подробности ошибки Описание
forbidden (403) channelClosed Канал, указанный в параметре channelId закрыт.
forbidden (403) channelSuspended Канал, указанный в параметре channelId , приостановлен.
forbidden (403) playlistForbidden Список воспроизведения, определенный параметром id запроса, не поддерживает запрос или запрос не авторизован должным образом.
notFound (404) channelNotFound Канал, указанный в параметре channelId , не найден.
notFound (404) playlistNotFound Невозможно найти список воспроизведения, указанный в параметре id запроса.
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность вывода указанного списка воспроизведения. Например, вы не можете указать плейлист «Посмотреть позже».

playlists.insert

Тип ошибки Подробности ошибки Описание
badRequest (400) defaultLanguageNotSetError Для обновления localizations необходимо установить defaultLanguage .
badRequest (400) localizationValidationError Одно из значений объекта локализации не прошло проверку. Используйте метод playlists.list для получения допустимых значений и обязательно обновите их, следуя рекомендациям в документации по ресурсам списков воспроизведения.
badRequest (400) maxPlaylistExceeded Невозможно создать плейлист, так как на канале уже имеется максимально допустимое количество плейлистов.
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован должным образом.
invalidValue (400) invalidPlaylistSnippet Запрос предоставляет недопустимый фрагмент плейлиста.
required (400) playlistTitleRequired В запросе должно быть указано название плейлиста.

playlists.update

Тип ошибки Подробности ошибки Описание
badRequest (400) defaultLanguageNotSetError Для обновления localizations необходимо установить defaultLanguage .
badRequest (400) localizationValidationError Одно из значений объекта локализации не прошло проверку. Используйте метод playlists.list для получения допустимых значений и обязательно обновите их, следуя рекомендациям в документации по ресурсам списков воспроизведения.
forbidden (403) playlistForbidden Эта операция запрещена или запрос не авторизован должным образом.
invalidValue (400) invalidPlaylistSnippet Запрос предоставляет недопустимый фрагмент плейлиста.
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность обновления указанного плейлиста. Например, вы не можете обновить свойства плейлиста загруженных вами видео.
notFound (404) playlistNotFound Невозможно найти список воспроизведения, указанный в параметре id запроса.
required (400) playlistTitleRequired В запросе должно быть указано название плейлиста.

subscriptions

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами subscriptions . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

subscriptions.delete

Тип ошибки Подробности ошибки Описание
forbidden (403) subscriptionForbidden Запрос не аутентифицирован должным образом или не поддерживается для этого канала.
notFound (404) subscriptionNotFound Подписка, которую вы пытаетесь удалить, не найдена. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

subscriptions.insert

Тип ошибки Подробности ошибки Описание
badRequest (400) subscriptionDuplicate Подписка, которую вы пытаетесь создать, уже существует.
badRequest (400) subscriptionForbidden Вы достигли максимального количества подписок.
badRequest (400) subscriptionForbidden Слишком много недавних подписок. Пожалуйста, повторите попытку через несколько часов.
badRequest (400) subscriptionForbidden Подписка на собственный канал не поддерживается.
forbidden (403) subscriptionForbidden Запрос не аутентифицирован должным образом или не поддерживается для этого канала.
notFound (404) publisherNotFound Ресурс, указанный в свойстве snippet.resourceId запроса, не найден.
notFound (404) subscriberNotFound Абонент, указанный в запросе, не найден.
required (400) publisherRequired Ресурс подписки, указанный в запросе, должен использовать свойство snippet.resourceId для идентификации канала, на который подписывается.

subscriptions.list

Тип ошибки Подробности ошибки Описание
forbidden (403) accountClosed Не удалось получить подписки, поскольку учетная запись подписчика закрыта.
forbidden (403) accountSuspended Не удалось получить подписки, поскольку учетная запись подписчика заблокирована.
forbidden (403) subscriptionForbidden Запрашивающей стороне не разрешен доступ к запрошенным подпискам.
notFound (404) subscriberNotFound Абонент, указанный в запросе, не найден.

thumbnails

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами thumbnails . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

thumbnails.set

Тип ошибки Подробности ошибки Описание
badRequest (400) invalidImage Предоставленное содержимое изображения недействительно.
badRequest (400) mediaBodyRequired Запрос не включает содержимое изображения.
forbidden (403) forbidden Миниатюру нельзя установить для указанного видео. Возможно, запрос не авторизован должным образом.
forbidden (403) forbidden Аутентифицированный пользователь не имеет разрешений на загрузку и установку собственных миниатюр видео.
notFound (404) videoNotFound Видео, для которого вы пытаетесь вставить миниатюру, не найдено. Проверьте значение параметра videoId запроса, чтобы убедиться в его правильности.
tooManyRequests (429) uploadRateLimitExceeded Недавно на канале было загружено слишком много миниатюр. Пожалуйста, повторите запрос позже.

videoAbuseReportReasons

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами videoAbuseReportReasons . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

videoAbuseReportReasons.list

Тип ошибки Подробности ошибки Описание
forbidden (403) forbidden Доступ запрещен. Возможно, запрос не был должным образом авторизован.

videoCategories

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами videoCategories . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

videoCategories.list

Тип ошибки Подробности ошибки Описание
notFound (404) videoCategoryNotFound Невозможно найти категорию видео, определенную параметром id . Используйте метод videoCategories.list для получения списка допустимых значений.

videos

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с videos . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

videos.insert

Тип ошибки Подробности ошибки Описание
badRequest (400) defaultLanguageNotSet Запрос пытается добавить локализованные сведения о видео без указания языка по умолчанию для сведений о видео.
badRequest (400) invalidCategoryId Свойство snippet.categoryId указывает недопустимый идентификатор категории. Используйте метод videoCategories.list для получения поддерживаемых категорий.
badRequest (400) invalidDescription В метаданных запроса указано недопустимое описание видео.
badRequest (400) invalidFilename Имя видеофайла, указанное в заголовке Slug , неверно.
badRequest (400) invalidPublishAt В метаданных запроса указано недопустимое запланированное время публикации.
badRequest (400) invalidRecordingDetails Объект recordingDetails в метаданных запроса указывает недопустимые сведения о записи.
badRequest (400) invalidTags В метаданных запроса указаны недопустимые ключевые слова видео.
badRequest (400) invalidTitle Метаданные запроса указывают на недопустимое или пустое название видео.
badRequest (400) invalidVideoGameRating В метаданных запроса указан недопустимый рейтинг видеоигры.
badRequest (400) invalidVideoMetadata Метаданные запроса недействительны. Эта ошибка возникает, если запрос обновляет фрагмент snippet video но не устанавливает значения для свойств snippet.title и snippet.categoryId .
badRequest (400) mediaBodyRequired Запрос не включает видеоконтент.
badRequest (400) uploadLimitExceeded Пользователь превысил количество видео, которые он может загрузить.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting Запрос пытается установить недействительную лицензию для видео.
forbidden (403) forbiddenPrivacySetting Запрос пытается установить недопустимые настройки конфиденциальности для видео.

videos.list

Тип ошибки Подробности ошибки Описание
badRequest (400) videoChartNotFound Запрошенная видеодиаграмма не поддерживается или недоступна.
forbidden (403) forbidden Запрос не авторизован должным образом для доступа к видеофайлу или обрабатываемой информации. Части fileDetails , processingDetails и suggestions доступны только владельцу этого видео.
forbidden (403) forbidden Запрос не может получить доступ к информации о рейтинге пользователя. Эта ошибка может возникнуть из-за того, что запросу не разрешено должным образом использовать параметр myRating .
notFound (404) videoNotFound Видео, которое вы пытаетесь получить, не найдено. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

videos.delete

Тип ошибки Подробности ошибки Описание
forbidden (403) forbidden Видео, которое вы пытаетесь удалить, удалить невозможно. Возможно, запрос не авторизован должным образом.
notFound (404) videoNotFound Видео, которое вы пытаетесь удалить, не найдено. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

videos.update

Тип ошибки Подробности ошибки Описание
badRequest (400) defaultLanguageNotSet Запрос API пытается добавить локализованные сведения о видео без указания языка по умолчанию для сведений о видео.
badRequest (400) invalidCategoryId Свойство snippet.categoryId указывает недопустимый идентификатор категории. Используйте метод videoCategories.list для получения поддерживаемых категорий.
badRequest (400) invalidDefaultBroadcastPrivacySetting Запрос пытается установить недопустимые настройки конфиденциальности для трансляции по умолчанию.
badRequest (400) invalidDescription В метаданных запроса указано недопустимое описание видео.
badRequest (400) invalidPublishAt В метаданных запроса указано недопустимое запланированное время публикации.
badRequest (400) invalidRecordingDetails Объект recordingDetails в метаданных запроса указывает недопустимые сведения о записи.
badRequest (400) invalidTags В метаданных запроса указаны недопустимые ключевые слова видео.
badRequest (400) invalidTitle Метаданные запроса указывают на недопустимое или пустое название видео.
badRequest (400) invalidVideoMetadata Метаданные запроса недействительны. Эта ошибка возникает, если запрос обновляет фрагмент snippet video но не устанавливает значения для свойств snippet.title и snippet.categoryId .
forbidden (403) forbidden Доступ запрещен. Возможно, запрос не был должным образом авторизован.
forbidden (403) forbiddenEmbedSetting Запрос пытается установить недопустимые настройки для встраивания видео. У некоторых каналов может не быть разрешения на использование встроенных проигрывателей для прямых трансляций. Дополнительную информацию можно найти в Справочном центре YouTube .
forbidden (403) forbiddenLicenseSetting Запрос пытается установить недействительную лицензию для видео.
forbidden (403) forbiddenPrivacySetting Запрос пытается установить недопустимые настройки конфиденциальности для видео.
notFound (404) videoNotFound Видео, которое вы пытаетесь обновить, не найдено. Проверьте значение поля id в теле запроса, чтобы убедиться в его правильности.

videos.rate

Тип ошибки Подробности ошибки Описание
badRequest (400) emailNotVerified Пользователь должен подтвердить свой адрес электронной почты перед тем, как поставить оценку.
badRequest (400) invalidRating Запрос содержал неожиданное значение параметра rating .
badRequest (400) videoPurchaseRequired Прокатным видео могут оценивать только пользователи, которые взяли их напрокат.
forbidden (403) forbidden Видео, которому вы пытаетесь оценить, не может быть оценено. Возможно, запрос не авторизован должным образом.
forbidden (403) videoRatingDisabled Владелец видео, которому вы пытаетесь оценить, отключил оценку этого видео.
notFound (404) videoNotFound Видео, которому вы пытаетесь оценить, не найдено. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

videos.reportAbuse

Тип ошибки Подробности ошибки Описание
badRequest (400) invalidAbuseReason Запрос содержал неожиданное значение поля reason_id или комбинацию полей reason_id и secondary_reason_id .
badRequest (400) rateLimitExceeded Пользователь отправил слишком много запросов за указанный период времени.
forbidden (403) forbidden
notFound (404) videoNotFound Видео, о нарушении которого вы пытаетесь сообщить, не найдено.

watermarks

В следующих таблицах указаны сообщения об ошибках, которые API возвращает в ответ на вызовы, связанные с ресурсами watermarks . Эти методы также могут возвращать ошибки, перечисленные в разделе «Распространенные ошибки запроса» .

watermarks.set

Тип ошибки Подробности ошибки Описание
badRequest (400) imageFormatUnsupported Предоставленное вами изображение имеет неподдерживаемый формат.
badRequest (400) imageTooTall Предоставленное вами изображение слишком высокое.
badRequest (400) imageTooWide Предоставленное вами изображение слишком широкое.
badRequest (400) mediaBodyRequired Запрос не включает содержимое изображения.
forbidden (403) forbidden Водяной знак не может быть установлен для указанного канала. Возможно, запрос не авторизован должным образом или для параметра channelId установлено недопустимое значение.

watermarks.unset

Тип ошибки Подробности ошибки Описание
forbidden (403) forbidden Водяной знак невозможно удалить для указанного канала. Возможно, запрос не авторизован должным образом или для параметра channelId установлено недопустимое значение.