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 Запрос API недействителен или неправильно сформирован. Следовательно, сервер API не смог понять запрос.
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) commentsDisabled Для видео, определенного параметром videoId , комментарии отключены.
forbidden (403) forbidden Одну или несколько запрошенных цепочек комментариев невозможно получить из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
notFound (404) channelNotFound Не удалось найти канал, определенный параметром allThreadsRelatedToChannelId .
notFound (404) commentThreadNotFound Невозможно найти одну или несколько из указанных цепочек комментариев. Проверьте значения параметра id запроса, чтобы убедиться в их правильности.
notFound (404) videoNotFound Не удалось найти видео, определенное параметром videoId .

commentThreads.insert

Тип ошибки Детализация ошибки Описание
badRequest (400) channelOrVideoIdMissing Каждая ветка комментариев должна быть связана с каналом или видео. Убедитесь, что ресурс указывает значения для свойств snippet.channelId и snippet.videoId . Комментарий к видео появляется на странице просмотра видео.
badRequest (400) commentTextRequired Вставляемый ресурс comment должен указать значение свойства snippet.topLevelComment.snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400) commentTextTooLong Вставляемый ресурс comment содержит слишком много символов в свойстве snippet.topLevelComment.snippet.textOriginal .
badRequest (400) invalidCommentThreadMetadata Метаданные запроса недействительны.
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) forbidden Ветка комментариев могла быть создана из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
forbidden (403) ineligibleAccount Учетная запись YouTube, используемая для авторизации запроса API, должна быть объединена с учетной записью Google пользователя, чтобы вставить комментарий или ветку комментариев.
notFound (404) channelNotFound Указанный канал не найден. Проверьте значение свойства snippet.channelId , чтобы убедиться в его правильности.
notFound (404) videoNotFound Указанное видео не найдено. Проверьте значение свойства snippet.videoId , чтобы убедиться в его правильности.

comments

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

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

comments.list

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

comments.setModerationStatus

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

comments.insert

Тип ошибки Детализация ошибки Описание
badRequest (400) commentTextRequired Вставляемый ресурс comment должен указать значение свойства snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400) commentTextTooLong Вставляемый ресурс comment содержит слишком много символов в свойстве snippet.textOriginal .
badRequest (400) invalidCommentMetadata Метаданные запроса недействительны.
badRequest (400) operationNotSupported Пользователь API не может вставить комментарий в ответ на комментарий верхнего уровня, определенный свойством snippet.parentId . В ресурсе commentThread свойство snippet.canReply указывает, может ли текущий зритель ответить на ветку.
badRequest (400) parentCommentIsPrivate Указанный родительский комментарий является частным. API не поддерживает ответы на частные комментарии.
badRequest (400) parentIdMissing Вставляемый комментарий должен быть связан с родительским комментарием. Однако ресурс comment в теле запроса API не указал значение свойства snippet.parentId .
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса comment в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) forbidden Комментарий не может быть создан из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
forbidden (403) ineligibleAccount Учетная запись YouTube, используемая для авторизации запроса API, должна быть объединена с учетной записью Google пользователя, чтобы вставить комментарий или ветку комментариев.
notFound (404) parentCommentNotFound Указанный родительский комментарий не найден. Проверьте значение свойства snippet.parentId в тексте запроса, чтобы убедиться в его правильности.

comments.delete

Тип ошибки Детализация ошибки Описание
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен.
forbidden (403) forbidden Комментарий не удалось удалить из-за недостаточного разрешения. Возможно, запрос не авторизован должным образом.
notFound (404) commentNotFound Указанный комментарий не найден. Проверьте значение параметра id запроса, чтобы убедиться, что оно правильное.

comments.update

Тип ошибки Детализация ошибки Описание
badRequest (400) commentTextTooLong Обновляемый ресурс comment содержит слишком много символов в свойстве snippet.textOriginal .
badRequest (400) invalidCommentMetadata Метаданные запроса недействительны.
badRequest (400) operationNotSupported Запрос API недействителен или неправильно сформирован. Следовательно, сервер API не смог понять запрос.
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса comment в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) forbidden Комментарий не удалось обновить из-за недостаточного разрешения. Возможно, запрос не авторизован должным образом.
forbidden (403) ineligibleAccount Учетная запись YouTube, используемая для авторизации запроса API, должна быть объединена с учетной записью Google пользователя, чтобы обновить комментарий или цепочку комментариев.
notFound (404) commentNotFound Указанный комментарий не найден. Проверьте значение свойства id в теле запроса, чтобы убедиться в его правильности.

members

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

members.list

Тип ошибки Детализация ошибки Описание
badRequest (400) channelMembershipsNotEnabled Канал автора, авторизовавший запрос, не поддерживает членство в канале.
badRequest (400) invalidMode Недопустимое значение параметра mode . Эта ошибка может возникнуть, если параметр pageToken указывает токен, полученный в режиме, отличном от указанного.
badRequest (400) invalidPageToken Недопустимое значение параметра pageToken . Эта ошибка возникает, если срок действия токена страницы, использованного в запросе, истек.
badRequest (400) invalidHasAccessToLevel Недопустимое значение параметра hasAccessToLevel . Уровня с указанным id не существует.
badRequest (400) invalidFilterByMemberChannelId Недопустимое значение параметра filterByMemberChannelId . Эта ошибка возникает, если значение параметра filterByMemberChannelId указывает более 100 каналов.

membershipsLevels

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

membershipsLevels.list

Тип ошибки Детализация ошибки Описание
badRequest (400) channelMembershipsNotEnabled Канал автора, авторизовавший запрос, не поддерживает членство в канале.

playlistItems

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

playlistItems.delete

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

playlistItems.insert

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

playlistItems.list

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

playlistItems.update

Тип ошибки Детализация ошибки Описание
forbidden (403) playlistItemsNotAccessible Запрос не является должным образом авторизован для обновления указанного элемента плейлиста.
invalidValue (400) invalidPlaylistItemPosition Запрос пытается установить позицию элемента Playlist на недопустимое или неподдерживаемое значение. Проверьте значение свойства position в snippet ресурса.
invalidValue (400) invalidResourceType type , указанный для идентификатора ресурса, не поддерживается для этой операции. Идентификатор ресурса идентифицирует элемент, добавляемый в список воспроизведения, такой как youtube#video .
invalidValue (400) invalidSnippet В запросе не указывается действительное свойство snippet .
invalidValue (400) manualSortRequired Запрос пытается установить позицию элемента плейлиста, но список воспроизведения не использует ручную сортировку. (Например, элементы плейлиста могут быть отсортированы по дате или популярности.) Вы можете обратиться к ошибке, удалив элемент snippet.position из ресурса, который вставляется запрос. Если вы хотите, чтобы элемент плейлиста занимал определенную позицию в списке, вам нужно сначала обновить опцию заказа списка воспроизведения, чтобы руководствовать в настройках списка воспроизведения. Эти настройки можно настроить в видео диспетчере Videobe .
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 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 Запрос должен указать название плейлиста.

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 устанавливается на неверное значение.