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. YouTube не поддерживает сервисные аккаунты, и если вы попытаетесь пройти аутентификацию с помощью сервисного аккаунта, вы получите эту ошибку.

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

activities

YouTube прекратил поддержку функции сводки каналов. activities.insert больше не поддерживается.

В следующих таблицах указаны сообщения об ошибках, которые 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 , не найдено.

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 Свойство snippet.defaultLanguage ресурса channelSection должно быть установлено для успешной вставки или обновления объекта localizations для этого ресурса.
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 Свойство snippet.defaultLanguage ресурса channelSection должно быть установлено для успешной вставки или обновления объекта localizations для этого ресурса.
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 . Используйте методguideCategories.list для получения списка допустимых значений.
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 Одно из значений объекта локализации не прошло проверку. Используйте метод 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 Указанный идентификатор канала недавноUploadedBy не найден.
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 В метаданных запроса в части invideoPromotion должен быть указан URL-адрес веб-сайта. Задайте значение свойства invideoPromotion.items[].id.websiteUrl в ресурсе, который отправляет запрос.

commentThreads

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

commentThreads.list

Тип ошибки Детализация ошибки Описание
badRequest (400) operationNotSupported Фильтр ID совместим только с комментариями на основе Google+.
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) commentsDisabled Для видео, определенного параметром videoId комментарии отключены.
forbidden (403) forbidden Одну или несколько запрошенных цепочек комментариев невозможно получить из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
notFound (404) channelNotFound Канал, определенный параметром channelId или allThreadsRelatedToChannelId , не найден.
notFound (404) commentThreadNotFound Невозможно найти одну или несколько из указанных цепочек комментариев. Проверьте значения параметра id запроса, чтобы убедиться в их правильности.
notFound (404) videoNotFound Видео, определенное параметром videoId , не найдено.

commentThreads.insert

Тип ошибки Детализация ошибки Описание
badRequest (400) channelOrVideoIdMissing Каждая ветка комментариев должна быть связана с каналом или видео.
  • Если комментарий относится к каналу, убедитесь, что ресурс, указанный в тексте запроса, предоставляет значение для свойства snippet.channelId . Комментарий, относящийся к каналу, отображается на вкладке «Обсуждение» канала.
  • Если комментарий относится к видео, убедитесь, что ресурс указывает значения для свойств 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

Метод comments.markAsSpam больше не поддерживается.

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

comments.list

Тип ошибки Детализация ошибки Описание
badRequest (400) operationNotSupported Фильтр идентификаторов совместим только с комментариями на основе Google+.
forbidden (403) forbidden Один или несколько запрошенных комментариев не могут быть получены из-за недостаточности разрешений. Возможно, запрос не авторизован должным образом.
notFound (404) commentNotFound Невозможно найти один или несколько указанных комментариев. Проверьте значения параметров id и parentId запроса, чтобы убедиться в их правильности.

comments.setModerationStatus

Тип ошибки Детализация ошибки Описание
badRequest (400) banWithoutReject Параметр banAuthor можно использовать только в том случае, если значение параметра moderationStatus rejected .
badRequest (400) operationNotSupported Комментарии, не основанные на Google+, предлагают лишь ограниченные функции модерации.
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 Обновляться могут только комментарии из Google+.
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 The playlist identified with the request's playlistId parameter cannot be found.
notFound (404) videoNotFound The video that you are trying to add to the playlist cannot be found. Check the value of the videoId property to ensure that it is correct.
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) resourceIdRequired The request must contain a resource in which the snippet object specifies a resourceId .

playlistItems.list

Error type Error detail Описание
forbidden (403) playlistItemsNotAccessible The request is not properly authorized to retrieve the specified playlist.
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 – eg 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 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.

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 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 could not be retrieved because the subscriber's account is closed.
forbidden (403) accountSuspended Subscriptions could not be retrieved because the subscriber's account is suspended.
forbidden (403) subscriptionForbidden The requester is not 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 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 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 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 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. Note that 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. Note that some channels may 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 e-mail 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 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.