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, но нет канала YouTube. Такие пользователи могут получить доступ ко многим функциям, которые зависят от авторизации пользователя, например к оценке видео или добавлению видео в плейлист watch_later. Например, чтобы загрузить видео, пользователю нужен канал YouTube. У пользователя с аккаунтом Gmail или устройством Android точно есть аккаунт Google, но он может быть не связан с каналом YouTube.

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

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

действия

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

субтитры

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

captions.delete

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

captions.download

Тип ошибки Сведения об ошибке Описание
forbidden (403) forbidden Разрешений, связанных с запросом, недостаточно для скачивания дорожки субтитров. Возможно, запрос не был авторизован должным образом.
invalidValue (400) couldNotConvert Не удалось преобразовать данные дорожки субтитров в запрошенный язык и/или формат. Убедитесь, что значения параметров tfmt и tlang действительны и что параметр snippet.status запрошенной дорожки субтитров не имеет значения failed.
notFound (404) captionNotFound Не удалось найти дорожку субтитров. Проверьте значение параметра id в запросе.

captions.insert

Тип ошибки Сведения об ошибке Описание
badRequest (400) contentRequired Запрос не содержит дорожку субтитров.
conflict (409) captionExists В указанном видео уже есть дорожка субтитров с заданными значениями snippet.language и snippet.name. У видео может быть несколько дорожек на одном языке, но у каждой должно быть уникальное название.

Эту ошибку можно исправить несколькими способами. Вы можете удалить существующую дорожку и вставить новую или изменить название новой дорожки перед ее вставкой.
forbidden (403) forbidden У разрешений, связанных с запросом, недостаточно прав для загрузки дорожки субтитров. Возможно, запрос не был авторизован должным образом.
invalidValue (400) invalidMetadata Запрос содержит недопустимые значения метаданных, которые не позволяют создать трек. Убедитесь, что в запросе указаны допустимые значения свойств snippet.language, snippet.name и snippet.videoId. Свойство snippet.isDraft также можно добавить, но это не обязательно.
notFound (404) videoNotFound Видео, указанное в параметре videoId, не найдено.
invalidValue (400) nameTooLong Значение snippet.name, указанное в запросе, слишком длинное. Максимальная длина – 150 символов.

captions.list

Тип ошибки Сведения об ошибке Описание
forbidden (403) forbidden Не удалось получить одну или несколько дорожек субтитров, поскольку у вас нет необходимых разрешений. Запрос может быть не авторизован.
notFound (404) captionNotFound Не удалось найти одну или несколько дорожек субтитров. Эта ошибка возникает, если параметр videoId указывает на существующее видео, а параметр id – на идентификаторы дорожек субтитров, которые не существуют, или на идентификаторы дорожек, связанные с другими видео. Проверьте значения параметров id и videoId в запросе.
notFound (404) videoNotFound Не удалось найти видео, указанное в параметре videoId.

captions.update

Тип ошибки Сведения об ошибке Описание
badRequest (400) contentRequired В запросе не был загружен обновленный файл субтитров. Если для параметра sync задано значение true, необходимо указать фактическое содержимое трека.
forbidden (403) forbidden Разрешений, связанных с запросом, недостаточно для обновления дорожки субтитров. Запрос может быть не авторизован.
notFound (404) captionNotFound Не удалось найти указанную дорожку субтитров. Проверьте значение параметра id в запросе.

channelBanners

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

channelBanners.insert

Тип ошибки Сведения об ошибке Описание
badRequest (400) bannerAlbumFull В альбоме "Фоновые изображения канала YouTube" слишком много изображений. Перейдите на страницу http://photos.google.com, откройте раздел с альбомами и удалите из нужного альбома несколько изображений.
badRequest (400) mediaBodyRequired Запрос не содержит контент изображения.

channelSections

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

channelSections.delete

Тип ошибки Сведения об ошибке Описание
badRequest (400) notEditable Этот раздел канала нельзя удалить.
forbidden (403) channelSectionForbidden Запрос не прошел аутентификацию или не поддерживается для этого канала.
invalidValue (400) idInvalid В свойстве id указан недопустимый идентификатор раздела канала.
invalidValue (400) idRequired В свойстве id должно быть указано значение, идентифицирующее удаляемый раздел канала.
notFound (404) channelNotFound Канал не найден.
notFound (404) channelSectionNotFound Не удалось найти раздел канала, который вы пытаетесь обновить.

channelSections.insert

Тип ошибки Сведения об ошибке Описание
badRequest (400) defaultLanguageNotSetError Чтобы вставить или обновить объект localizations для ресурса channelSection, необходимо задать свойство snippet.defaultLanguage этого ресурса.
badRequest (400) invalidLanguage Один из ключей языка объекта localizations не прошел проверку. Чтобы получить допустимые значения и обновить их, следуйте инструкциям в документации по ресурсу channelSections и используйте метод channelSections.list.
badRequest (400) notEditable Не удалось создать раздел канала.
badRequest (400) styleRequired В ресурсе channelSection должно быть указано значение для поля snippet.style.
badRequest (400) targetInvalidCountry Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) targetInvalidLanguage Одно из значений в списке targeting.languages не прошло проверку. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) targetInvalidRegion Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) typeRequired В ресурсе channelSection должно быть указано значение для поля snippet.type.
forbidden (403) channelSectionForbidden Запрос не прошел аутентификацию или не поддерживается для этого канала.
invalidValue (400) channelNotActive По крайней мере один из указанных каналов неактивен.
invalidValue (400) channelsDuplicated Обработать запрос не удалось, так как в нем указаны повторяющиеся каналы.
invalidValue (400) channelsNeeded Если свойство snippet.type имеет значение multipleChannels, то необходимо указать свойство contentDetails.channels[] и задать в нем хотя бы один канал.
invalidValue (400) channelsNotExpected В ресурсе, предоставленном вместе с запросом, указано значение свойства contentDetails.channels[], но для этого типа раздела канала не ожидаются каналы.
invalidValue (400) contentDetailsNeeded Вставляемый ресурс должен содержать объект contentDetails для этого типа раздела канала.
invalidValue (400) inValidPosition Свойство snippet.position содержит недопустимое значение.
invalidValue (400) maxChannelSectionExceeded Запрос не может быть выполнен, поскольку на канале уже есть максимальное количество разделов.
invalidValue (400) maxChannelsExceeded Обработать запрос не удалось, так как в разделе "Каналы" слишком много каналов.
invalidValue (400) maxPlaylistExceeded Не удалось обработать запрос, так как в раздел канала было добавлено слишком много плейлистов.
invalidValue (400) onePlaylistNeeded Если свойство snippet.type имеет значение singlePlaylist, то свойство contentDetails.playlists[] должно содержать ровно один плейлист.
invalidValue (400) ownChannelInChannels Вы не можете добавить свой канал в раздел, который показывается на этом канале.
invalidValue (400) playlistIsPrivate Один или несколько указанных плейлистов являются частными и поэтому не могут быть включены в раздел канала.
invalidValue (400) playlistsDuplicated Обработать запрос не удалось, так как в нем были указаны повторяющиеся плейлисты.
invalidValue (400) playlistsNeeded Если свойство snippet.type имеет значение singlePlaylist или multiplePlaylists, то свойство contentDetails.playlists[] должно быть указано.
invalidValue (400) playlistsNotExpected В ресурсе, указанном в запросе, задано значение свойства contentDetails.playlists[], но для этого типа раздела канала плейлисты не предусмотрены.
invalidValue (400) snippetNeeded Чтобы создать раздел канала, необходимо указать snippet.
invalidValue (400) titleLengthExceeded Слишком длинное значение свойства snippet.title.
invalidValue (400) titleRequired Если свойство snippet.type имеет значение multiplePlaylists или multipleChannels, то вы должны задать название раздела, указав значение для свойства snippet.title.
notFound (404) channelNotFound Не удалось найти один или несколько указанных каналов.
notFound (404) playlistNotFound Не удалось найти один или несколько указанных плейлистов.

channelSections.list

Тип ошибки Сведения об ошибке Описание
forbidden (403) channelSectionForbidden У пользователя, отправившего запрос, нет доступа к запрошенным разделам канала.
invalidValue (400) idInvalid В запросе указан недействительный идентификатор раздела канала.
invalidValue (400) invalidCriteria Не удалось выполнить запрос, так как критерии фильтрации недействительны.
notFound (404) channelNotFound Не удалось найти канал, указанный в запросе.
notFound (404) channelSectionNotFound Не удалось найти раздел канала, указанный в запросе.

channelSections.update

Тип ошибки Сведения об ошибке Описание
badRequest (400) defaultLanguageNotSetError Чтобы вставить или обновить объект localizations для ресурса channelSection, необходимо задать свойство snippet.defaultLanguage этого ресурса.
badRequest (400) invalidLanguage Не удалось проверить один из языковых ключей объекта localizations. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) notEditable Этот раздел канала нельзя изменить.
badRequest (400) styleRequired В ресурсе channelSection должно быть указано значение поля snippet.style.
badRequest (400) targetInvalidCountry Одно из значений в списке targeting.countries не прошло проверку. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) targetInvalidLanguage Одно из значений в списке targeting.languages не прошло проверку. Чтобы получить допустимые значения и обновить их, следуйте инструкциям в документации по ресурсу channelSections и используйте метод channelSections.list.
badRequest (400) targetInvalidRegion Одно из значений в списке targeting.regions не прошло проверку. Используйте метод channelSections.list, чтобы получить допустимые значения и обновить их в соответствии с инструкциями в документации по ресурсу channelSections.
badRequest (400) typeRequired В ресурсе channelSection должно быть указано значение поля snippet.type.
forbidden (403) channelSectionForbidden Запрос не прошел аутентификацию или не поддерживается для этого канала.
invalidValue (400) channelNotActive По крайней мере один из указанных каналов неактивен.
invalidValue (400) channelsDuplicated Обработать запрос не удалось, так как в нем указаны повторяющиеся каналы.
invalidValue (400) channelsNeeded Если свойство snippet.type имеет значение multipleChannels, то необходимо указать свойство contentDetails.channels[] и задать в нем хотя бы один канал.
invalidValue (400) channelsNotExpected В ресурсе, предоставленном вместе с запросом, указано значение свойства contentDetails.channels[], но для этого типа раздела канала не ожидаются каналы.
invalidValue (400) contentDetailsNeeded Ресурс, который вы обновляете, должен содержать объект contentDetails для этого типа раздела канала.
invalidValue (400) idInvalid В свойстве id указан недопустимый идентификатор раздела канала.
invalidValue (400) idRequired В свойстве id должно быть указано значение, идентифицирующее обновляемый раздел канала.
invalidValue (400) inValidPosition Свойство snippet.position содержит недопустимое значение.
invalidValue (400) maxChannelsExceeded Обработать запрос не удалось, так как в разделе каналов указано слишком много каналов.
invalidValue (400) maxPlaylistExceeded Не удалось обработать запрос, так как в раздел канала было добавлено слишком много плейлистов.
invalidValue (400) onePlaylistNeeded Если свойство snippet.type имеет значение singlePlaylist, то свойство contentDetails.playlists[] должно содержать ровно один плейлист.
invalidValue (400) ownChannelInChannels Вы не можете добавить свой канал в раздел, который показывается на этом канале.
invalidValue (400) playlistIsPrivate Один или несколько указанных плейлистов являются частными и поэтому не могут быть включены в раздел канала.
invalidValue (400) playlistsDuplicated Обработать запрос не удалось, так как в нем были указаны повторяющиеся плейлисты.
invalidValue (400) playlistsNeeded Если свойство snippet.type имеет значение singlePlaylist или multiplePlaylists, то свойство contentDetails.playlists[] должно быть указано.
invalidValue (400) playlistsNotExpected В ресурсе, указанном в запросе, задано значение свойства contentDetails.playlists[], но для этого типа раздела канала плейлисты не предусмотрены.
invalidValue (400) snippetNeeded Чтобы обновить раздел канала, необходимо указать snippet.
invalidValue (400) titleLengthExceeded Слишком длинное значение свойства snippet.title.
invalidValue (400) titleRequired Если свойство snippet.type имеет значение multiplePlaylists или multipleChannels, то вы должны задать название раздела, указав значение для свойства snippet.title.
notFound (404) channelNotFound Один или несколько указанных каналов не найдены.
notFound (404) channelSectionNotFound Не удалось найти раздел канала, который вы пытаетесь обновить.
notFound (404) playlistNotFound Один или несколько указанных плейлистов не найдены.

каналы

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

channels.list

Тип ошибки Сведения об ошибке Описание
badRequest (400) invalidCriteria Можно указать не более одного из следующих фильтров:id, mySubscribers, categoryId, mine, managedByMe, forUsername. Если аутентификация владельца контента выполняется с помощью параметра onBehalfOfContentOwner, можно указать только id или managedByMe.
forbidden (403) channelForbidden Канал, указанный в параметре id, не поддерживает запрос или запрос не авторизован должным образом.
notFound (404) categoryNotFound Не удалось найти категорию, указанную в параметре categoryId.
notFound (404) channelNotFound Не удалось найти канал, указанный в параметре id.

channels.update

Тип ошибки Сведения об ошибке Описание
badRequest (400) brandingValidationError Одно из значений в объекте brandingSettings не прошло проверку. Используйте метод channels.list, чтобы получить текущие настройки канала, и обновите значения свойств, следуя инструкциям в документации по ресурсу channels.
badRequest (400) channelTitleUpdateForbidden При обновлении brandingSettings part канала необходимо задать для свойства brandingSettings.channel.title текущее название канала или опустить это свойство. Если вы измените значение свойства, API вернет ошибку.
badRequest (400) defaultLanguageNotSetError Чтобы обновить localizations, необходимо задать defaultLanguage.
badRequest (400) invalidBrandingOption Один из указанных вами параметров брендинга не существует. Используйте метод channels.list, чтобы получить допустимые значения, и обновите их в соответствии с инструкциями в документации по ресурсу channels.
badRequest (400) invalidCustomMessage В метаданных запроса указано недопустимое специальное сообщение. Проверьте значение свойства invideoPromotion.items[].customMessage в ресурсе, который отправил запрос.
badRequest (400) invalidDuration В метаданных запроса указана недопустимая продолжительность в части invideoPromotion.
badRequest (400) invalidDuration В метаданных запроса указан недопустимый тип позиции для определения того, как продвигаемый объект размещается в видеопроигрывателе. Проверьте значение свойства invideoPromotion.position.type в ресурсе, который был отправлен в запросе.
badRequest (400) invalidRecentlyUploadedBy В метаданных запроса указан недопустимый идентификатор канала. Проверьте значение свойства invideoPromotion.items[].id.recentlyUploadedBy в ресурсе, который был отправлен в запросе.
badRequest (400) invalidTimingOffset В метаданных запроса указано недопустимое смещение по времени в разделе invideoPromotion.
badRequest (400) invalidTimingOffset В метаданных запроса указано недопустимое смещение по времени, которое определяет, когда продвигаемый объект должен показываться в видеопроигрывателе. Проверьте значение свойства invideoPromotion.timing.offsetMs в ресурсе, который отправил запрос.
badRequest (400) invalidTimingType В метаданных запроса указан недопустимый метод определения времени показа рекламируемого объекта в видеопроигрывателе. Проверьте значение свойства invideoPromotion.timing.type в ресурсе, который отправил запрос.
badRequest (400) localizationValidationError Одно из значений в объекте localizations не прошло проверку. Чтобы получить допустимые значения, используйте метод channels.list. Обновите их в соответствии с инструкциями в документации по ресурсу channels.
badRequest (400) tooManyPromotedItems В разделе invideoPromotion превышено допустимое количество продвигаемых объектов.
forbidden (403) channelForbidden Канал, указанный в параметре id, не поддерживает запрос, или запрос не авторизован должным образом.
forbidden (403) promotedVideoNotAllowed Не удалось найти канал, который вы пытаетесь обновить с помощью запроса к API. Проверьте значение свойства id в ресурсе channel, который был отправлен в запросе, чтобы убедиться, что идентификатор канала указан правильно.
forbidden (403) websiteLinkNotAllowed Указанный URL сайта недопустим.
notFound (404) channelNotFound Канал, указанный в параметре id, не найден или не имеет параметров фирменного оформления.
notFound (404) channelNotFound Не удалось найти канал, указанный в параметре id.
notFound (404) unknownChannelId Указанный идентификатор канала не найден.
notFound (404) unknownChannelId Не удалось найти указанный идентификатор канала recentlyUploadedBy.
notFound (404) unknownVideoId Не удалось найти идентификатор видео, указанный в качестве продвигаемого объекта.
required (400) requiredItemIdType В метаданных запроса необходимо указать тип объекта в разделе invideoPromotion.
required (400) requiredItemId В метаданных запроса должен быть указан объект в части invideoPromotion.
required (400) requiredTimingOffset В метаданных запроса должно быть указано смещение по времени по умолчанию, чтобы система YouTube могла определить, когда показывать продвигаемый объект. Задайте значение свойства invideoPromotion.defaultTiming.offsetMs в ресурсе, который отправляет запрос.
required (400) requiredTimingOffset В метаданных запроса необходимо указать смещение по времени, чтобы система YouTube могла определить, когда показывать продвигаемый объект. Задайте значение свойства invideoPromotion.timing.offsetMs в ресурсе, который отправляет запрос.
required (400) requiredTimingType В метаданных запроса должен быть указан метод временных меток, чтобы YouTube мог определить, когда показывать продвигаемый объект. Задайте значение свойства invideoPromotion.defaultTiming.type в ресурсе, который отправляет запрос.
required (400) requiredTimingType В метаданных запроса должен быть указан метод синхронизации, чтобы система YouTube могла определить, когда показывать продвигаемый объект. Задайте значение свойства invideoPromotion.timing.type в ресурсе, который отправляет запрос.
required (400) requiredTiming В метаданных запроса должно быть указано время для каждого элемента в части invideoPromotion.
required (400) requiredVideoId В метаданных запроса должен быть указан идентификатор видео, чтобы можно было определить продвигаемый объект.
required (400) requiredWebsiteUrl В метаданных запроса в части invideoPromotion должен быть указан URL сайта. Задайте значение свойства 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.

комментарии

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

comments.list

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

comments.setModerationStatus

Тип ошибки Сведения об ошибке Описание
badRequest (400) banWithoutReject Параметр banAuthor можно использовать, только если для параметра moderationStatus задано значение rejected.
badRequest (400) operationNotSupported Запрос к API недействителен или неправильно сформирован. Поэтому сервер API не может его распознать.
badRequest (400) processingFailure Серверу API не удалось обработать запрос. Это может быть временная ошибка, но обычно она указывает на то, что входные данные запроса недействительны.
forbidden (403) forbidden Не удалось задать статус модерации для одного или нескольких комментариев из-за недостаточных разрешений. Запрос может быть не авторизован.
notFound (404) commentNotFound Не удалось найти один или несколько комментариев, которые вы пытаетесь обновить. Проверьте значения параметра id в запросе.

comments.insert

Тип ошибки Сведения об ошибке Описание
badRequest (400) commentTextRequired В добавляемом ресурсе comment должно быть указано значение свойства snippet.textOriginal. Комментарий не может быть пустым.
badRequest (400) commentTextTooLong В свойстве snippet.textOriginal добавляемого ресурса comment слишком много символов.
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 В свойстве snippet.textOriginal ресурса comment, который вы обновляете, слишком много символов.
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 в теле запроса.

участники

В таблицах ниже перечислены сообщения об ошибках, которые 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 В ресурсе playlistItem, указанном в запросе, должно быть свойство id, которое идентифицирует обновляемый объект.

плейлисты

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

playlists.update

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

подписки

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

значки

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

видео

В таблицах ниже приведены сообщения об ошибках, которые 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 Достигнут суточный лимит загрузки видео. Это ограничение платформы YouTube, которое не связано с квотой API в вашем облачном проекте Google Cloud.
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 Видео, на которое вы хотите пожаловаться, не найдено.

водяные знаки

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