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 , не найдено.
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 Свойство 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 Список воспроизведения, указанный в параметре playlistId запроса, не найден.
notFound (404) videoNotFound Видео, которое вы пытаетесь добавить в плейлист, не найдено. Проверьте значение свойства videoId , чтобы убедиться, что оно правильное.
required (400) channelIdRequired В запросе не указано значение обязательного свойства channelId .
required (400) playlistIdRequired В запросе не указано значение обязательного свойства playlistId .
required (400) resourceIdRequired Запрос должен содержать ресурс, в котором объект snippet указывает resourceId .

playlistItems.list

Тип ошибки Детализация ошибки Описание
forbidden (403) playlistItemsNotAccessible Запрос не авторизован должным образом для получения указанного списка воспроизведения.
notFound (404) playlistNotFound Список воспроизведения, указанный в параметре playlistId запроса, не найден.
notFound (404) videoNotFound Видео, указанное в параметре videoId запроса, не найдено.
required (400) playlistIdRequired В запросе на подписку не указано значение обязательного свойства playlistId .
invalidValue (400) playlistOperationUnsupported API не поддерживает возможность включения видео в указанный плейлист. Например, вы не можете добавить видео в плейлист «Посмотреть позже».

playlistItems.update

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

playlists

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

playlists.delete

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

playlists.list

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

playlists.insert

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

playlists.update

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

subscriptions

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

subscriptions.delete

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

subscriptions.insert

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

subscriptions.list

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

thumbnails

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

thumbnails.set

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

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

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

videos

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

videos.insert

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

videos.list

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

videos.delete

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

videos.update

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

videos.rate

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

videos.reportAbuse

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

watermarks

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

watermarks.set

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

watermarks.unset

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