Channels

Теперь в API можно отмечать каналы и видео как предназначенные для детей. Кроме того, ресурсы channel и video теперь содержат свойство, которое определяет статус канала или видео ("предназначено для детей"). 10 января 2020 г. также были обновлены Условия использования сервисов YouTube API и правила для разработчиков. Подробнее об этом можно узнать из истории изменений YouTube Data API Service и Условий использования сервисов YouTube API.

Ресурс channel содержит информацию о канале YouTube.

Методы

API поддерживает следующие методы для ресурсов channels:

list

Возвращает коллекцию из одного или нескольких ресурсов channel, соответствующих критериям запроса. Попробовать

update

Обновляет метаданные канала. Обратите внимание, что в настоящее время этот метод поддерживает только обновление объектов brandingSettings и invideoPromotion ресурса channel и их дочерних свойств. Попробовать

Представление ресурса

Ниже показана структура JSON для ресурса channels.

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Свойства

В таблице ниже описаны свойства, которые появляются в этом ресурсе.

Свойства
kind	string Тип ресурса API. Значение будет youtube#channel.
etag	etag Тег Etag этого ресурса.
id	string Идентификатор, который YouTube использует для уникальной идентификации канала.
snippet	object Объект snippet содержит основные сведения о канале, такие как название, описание и значки.
snippet.title	string Название канала.
snippet.description	string Описание канала. Значение свойства может содержать не более 1000 символов.
snippet.customUrl	string Собственный URL канала. В Справочном центре YouTube рассказывается о требованиях к каналам, для которых можно создать собственный URL, и о том, как это сделать.
snippet.publishedAt	datetime Дата и время создания канала. Значение указывается в формате ISO 8601.
snippet.thumbnails	object Карта значков, связанных с каналом. Для каждого объекта на карте ключ – это название значка, а значение – это объект, содержащий другую информацию о значке. При отображении значков в приложении убедитесь, что ваш код использует URL изображений точно в том виде, в котором они возвращаются в ответах API. Например, в URL, возвращаемом в ответе API, ваше приложение не должно использовать домен http вместо домена https. URL значков каналов доступны только в домене https, и именно в таком виде они возвращаются в ответах API. Если ваше приложение пытается загрузить изображения YouTube из домена http, они могут не отображаться. Для новых каналов значки могут быть пустыми. Они появятся в течение одного дня.
snippet.thumbnails.(key)	object Допустимые значения ключей: default – уменьшенное изображение по умолчанию. Значок по умолчанию для видео или ресурса, который ссылается на видео (например, для элемента плейлиста или результата поиска), имеет ширину 120 пикселей и высоту 90 пикселей. По умолчанию значок канала имеет размер 88 x 88 пикселей. medium – значок в более высоком разрешении. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение размером 240 x 240 пикселей. high – версия значка в высоком разрешении. Для видео (или ресурса, который ссылается на видео) размер изображения составляет 480 x 360 пикселей. Для канала это изображение размером 800 x 800 пикселей.
snippet.thumbnails.(key).url	string URL изображения. Дополнительные рекомендации по использованию URL значков в приложении можно найти в определении свойства snippet.thumbnails.
snippet.thumbnails.(key).width	unsigned integer Ширина изображения.
snippet.thumbnails.(key).height	unsigned integer Высота изображения.
snippet.defaultLanguage	string Язык текста в свойствах snippet.title и snippet.description ресурса channel.
snippet.localized	object Объект snippet.localized содержит локализованное название и описание канала или название и описание канала на языке по умолчанию для метаданных канала. Локализованный текст возвращается в фрагменте ресурса, если в запросе channels.list использовался параметр hl, указывающий язык, для которого должен возвращаться локализованный текст, значение параметра hl идентифицирует язык приложения YouTube и локализованный текст доступен на этом языке. Если значение параметра hl не указано или указано, но локализованные метаданные для выбранного языка недоступны, возвращаются метаданные на языке по умолчанию. Свойство содержит значение, доступное только для чтения. Чтобы добавить, обновить или удалить локализованные метаданные, используйте объект localizations.
snippet.localized.title	string Локализованное название канала.
snippet.localized.description	string Локализованное описание канала.
snippet.country	string Страна, с которой связан канал. Чтобы задать значение этого свойства, измените значение свойства brandingSettings.channel.country.
contentDetails	object Объект contentDetails содержит информацию о контенте канала.
contentDetails.relatedPlaylists	object Объект relatedPlaylists представляет собой карту, на которой указаны плейлисты, связанные с каналом, например загруженные или понравившиеся видео. Получить любой из этих плейлистов можно с помощью метода playlists.list.
contentDetails.relatedPlaylists.likes	string Идентификатор плейлиста с понравившимися видео. Чтобы добавить или удалить элементы из этого списка, используйте методы playlistItems.insert и playlistItems.delete.
contentDetails.relatedPlaylists.favorites	string Это свойство устарело. Идентификатор плейлиста, в котором собраны любимые видео канала. Для добавления и удаления элементов из этого списка используйте методы playlistItems.insert и playlistItems.delete. Обратите внимание, что функция добавления видео в избранное больше не поддерживается. Например, свойство statistics.favoriteCount ресурса video перестало поддерживаться 28 августа 2015 г. В результате по историческим причинам это значение свойства может содержать идентификатор плейлиста, который относится к пустому плейлисту и, следовательно, не может быть получен.
contentDetails.relatedPlaylists.uploads	string Идентификатор плейлиста, в котором содержатся загруженные на канал видео. Используйте метод videos.insert, чтобы загружать новые видео, и метод videos.delete, чтобы удалять ранее загруженные видео.
statistics	object Объект statistics содержит статистику канала.
statistics.viewCount	unsigned long Общее количество просмотров всех видео на канале во всех форматах. С 24 августа 2026 года для всех форматов видео на канале (обычных видео, трансляций и Shorts) viewCount будет учитывать просмотры с момента начала воспроизведения (включая автозапуск, наведение указателя и нажатие кнопки "Воспроизвести").
statistics.commentCount	unsigned long Это свойство больше не поддерживается. Количество комментариев на канале.
statistics.subscriberCount	unsigned long Количество подписчиков канала. Это значение округляется до трех значащих цифр. Подробнее о том, как округляется количество подписчиков, можно узнать в истории изменений или Справочном центре YouTube.
statistics.hiddenSubscriberCount	boolean Указывает, видно ли число подписчиков канала всем пользователям.
statistics.videoCount	unsigned long Количество видео с открытым доступом, загруженных на канал. Обратите внимание, что значение отражает количество только общедоступных видео канала, даже для владельцев. Это соответствует данным, которые показываются на сайте YouTube.
topicDetails	object Объект topicDetails содержит информацию о темах, связанных с каналом. Важно! Подробнее об изменениях, связанных с идентификаторами тем, можно узнать из определения свойства topicDetails.topicIds[] и истории изменений.
topicDetails.topicIds[]	list Список идентификаторов тем, связанных с каналом. Это свойство не поддерживается с 10 ноября 2016 года. Поддержка будет прекращена 10 ноября 2017 г. Важно! В связи с прекращением поддержки Freebase и Freebase API с 27 февраля 2017 г. идентификаторы тем работают по-другому. Тогда YouTube начал возвращать небольшое количество отобранных идентификаторов тем. Посмотреть идентификаторы тем, поддерживаемые с 15 февраля 2017 г. Темы Музыкальные темы /m/04rlf Музыка (родительская тема) /m/02mscn христианская музыка /m/0ggq0m Классическая музыка /m/01lyv Страна /m/02lkt Электронная музыка /m/0glt670 Хип-хоп /m/05rwpb Независимая музыка /m/03_d0 Джаз /m/028sqc Азиатская музыка /m/0g293 Латиноамериканская музыка /m/064t9 Поп-музыка /m/06cqb Регги /m/06j6l Ритм-энд-блюз /m/06by7 Рок-музыка /m/0gywn Соул Темы игр /m/0bzvm2 Игры (родительская тема) /m/025zzc Экшен-игра /m/02ntfj Приключенческая экшен-игра /m/0b1vjn Казуальная игра /m/02hygl Музыкальная видеоигра /m/04q1x3q Видеоигра-головоломка /m/01sjng Гоночная видеоигра /m/0403l3g Ролевая видеоигра /m/021bp2 Видеоигра-симулятор /m/022dc6 Спортивная игра /m/03hf_rm Стратегическая видеоигра Спортивные темы /m/06ntj Спорт (родительская тема) /m/0jm_ Американский футбол /m/018jz Бейсбол /m/018w8 Баскетбол /m/01cgz Бокс /m/09xp_ Крикет /m/02vx4 Футбол /m/037hz Гольф /m/03tmr Хоккей /m/01h7lh Смешанные единоборства /m/0410tth Мотоспорт /m/07bs0 Теннис /m/07_53 Волейбол Темы развлечений /m/02jjt Развлечения (родительская тема) /m/09kqc Юмор /m/02vxn фильма; /m/05qjc Исполнительское искусство /m/066wd Реслинг /m/0f2f9 сериала; Темы, связанные со стилем жизни /m/019_rr Стиль жизни (родительская тема) /m/032tl Мода /m/027x7n Фитнес /m/02wbm Еда /m/03glg увлечения; /m/068hy Домашние животные /m/041xxh Физическая привлекательность [Красота] /m/07c1v Технологии /m/07bxq Туризм /m/07yv9 Транспортные средства Темы, связанные с обществом /m/098wr Общество (родительская тема) /m/09s1f Бизнес /m/0kt51 Здоровье /m/01h6rj Вооруженные силы /m/05qt0 Политика /m/06bvp Религия Другие темы /m/01k8wb База знаний
topicDetails.topicCategories[]	list Список URL страниц Википедии, описывающих контент канала.
status	object Объект status содержит информацию о настройках конфиденциальности канала.
status.privacyStatus	string Статус конфиденциальности канала. Допустимые значения: private public unlisted
status.isLinked	boolean Указывает, идентифицируют ли данные канала пользователя, который уже связан с именем пользователя YouTube или аккаунтом Google+. Пользователь, у которого есть одна из этих ссылок, уже имеет общедоступный идентификатор YouTube, который является обязательным условием для нескольких действий, таких как загрузка видео.
status.longUploadsStatus	string Указывает, можно ли загружать на канал видео продолжительностью более 15 минут. Это свойство возвращается, только если владелец канала авторизовал запрос к API. Подробную информацию об этой функции можно найти в Справочном центре YouTube. Допустимые значения этого свойства: allowed – на канал можно загружать видео продолжительностью более 15 минут. disallowed – на этом канале нельзя загружать видео продолжительностью более 15 минут. Канал может загружать длинные видео, только если у него хорошая репутация в соответствии с правилами сообщества YouTube и на его контент не наложены блокировки Content ID. После того как владелец канала устранит проблемы, из-за которых он не может загружать более длинные видео, канал вернется в состояние allowed или eligible. eligible – на канал можно загружать видео продолжительностью более 15 минут. Однако сначала владелец канала должен включить возможность загружать более длинные видео, подтвердив номер телефона. Подробнее об этой функции рассказывается в Справочном центре YouTube.
status.madeForKids	boolean Это значение указывает, предназначен ли канал для детей, и содержит текущий статус канала "Для детей". Например, статус может определяться на основе значения свойства selfDeclaredMadeForKids. Дополнительную информацию о том, как указать аудиторию канала, видео или трансляции, можно найти в Справочном центре YouTube .
status.selfDeclaredMadeForKids	boolean В запросе channels.update это свойство позволяет владельцу канала указать, что канал предназначен для детей. Значение свойства возвращается, только если владелец канала авторизовал запрос к API.
brandingSettings	object Объект brandingSettings содержит информацию о брендинге канала.
brandingSettings.channel	object Объект channel содержит свойства, связанные с оформлением страницы канала.
brandingSettings.channel.title	string Название канала. Максимальная длина названия – 30 символов.
brandingSettings.channel.description	string Описание канала, которое показывается в окне с информацией о канале на его странице. Максимальная длина значения свойства – 1000 символов.
brandingSettings.channel.keywords	string Ключевые слова, связанные с вашим каналом. Значение представляет собой список строк, разделенных пробелами. Ключевые слова канала могут быть усечены, если они превышают максимально допустимую длину в 500 символов или содержат неэкранированные кавычки ("). Обратите внимание, что ограничение в 500 символов относится не к каждому ключевому слову, а к их общей длине.
brandingSettings.channel.trackingAnalyticsAccountId	string Идентификатор аккаунта Google Аналитики, который вы хотите использовать для отслеживания и измерения трафика на канале.
brandingSettings.channel.unsubscribedTrailer	string Видео, которое должно воспроизводиться в модуле рекомендуемого видео на странице канала для пользователей, не подписанных на него. Подписчики могут видеть другое видео, в котором рассказывается о последних действиях на канале. Если указано, значением свойства должен быть идентификатор общедоступного видео или видео с ограниченным доступом, принадлежащего владельцу канала.
brandingSettings.channel.defaultLanguage	string Язык текста в свойствах snippet.title и snippet.description ресурса channel.
brandingSettings.channel.country	string Страна, с которой связан канал. Измените это свойство, чтобы задать значение свойства "snippet.country".
brandingSettings.watch	object Примечание. Этот объект и все его дочерние свойства больше не поддерживаются. Объект watch содержит свойства, связанные с оформлением страниц просмотра видео на канале.
brandingSettings.watch.textColor	string Примечание. Этот ресурс больше не поддерживается. Цвет текста в брендированной области страницы просмотра видео.
brandingSettings.watch.backgroundColor	string Примечание. Этот ресурс больше не поддерживается. Цвет фона для брендированной области на странице просмотра видео.
brandingSettings.watch.featuredPlaylistId	string Примечание. Этот ресурс больше не поддерживается. Если вы попытаетесь задать значение этого параметра, API вернет ошибку.
brandingSettings.image	object Это свойство и все его дочерние свойства больше не поддерживаются. Объект image содержит информацию об изображениях, которые показываются на странице канала или страницах просмотра видео.
brandingSettings.image.bannerImageUrl	string Это свойство больше не поддерживается. URL баннера, который показывается на странице канала на сайте YouTube. Размер изображения – 1060 x 175 пкс.
brandingSettings.image.bannerMobileImageUrl	string Это свойство больше не поддерживается. URL баннера, который показывается на странице канала в мобильных приложениях. Размер изображения – 640 x 175 пкс.
brandingSettings.image.watchIconImageUrl	string Это свойство больше не поддерживается. URL изображения, которое появляется над видеопроигрывателем. Это изображение высотой 25 пикселей и шириной не более 170 пикселей. Если вы не добавите изображение, вместо него будет показываться название канала.
brandingSettings.image.trackingImageUrl	string Это свойство больше не поддерживается. URL пикселя отслеживания размером 1 x 1, который можно использовать для сбора статистики по просмотрам страниц канала или видео.
brandingSettings.image.bannerTabletLowImageUrl	string Это свойство больше не поддерживается. URL баннера с низким разрешением, который показывается на странице канала в приложениях для планшетов. Максимальный размер изображения – 1138 x 188 пкс.
brandingSettings.image.bannerTabletImageUrl	string Это свойство больше не поддерживается. URL баннера, который показывается на странице канала в приложениях для планшетов. Размер изображения – 1707 x 283 пкс.
brandingSettings.image.bannerTabletHdImageUrl	string Это свойство больше не поддерживается. URL баннера с высоким разрешением, который показывается на странице канала в приложениях для планшетов. Максимальный размер изображения – 2276 x 377 пкс.
brandingSettings.image.bannerTabletExtraHdImageUrl	string Это свойство больше не поддерживается. URL баннера со сверхвысоким разрешением, который показывается на странице канала в приложениях для планшетов. Максимальный размер изображения – 2560 x 424 пикселя.
brandingSettings.image.bannerMobileLowImageUrl	string Это свойство больше не поддерживается. URL баннера с низким разрешением, который показывается на странице канала в мобильных приложениях. Максимальный размер изображения – 320 x 88 пкс.
brandingSettings.image.bannerMobileMediumHdImageUrl	string Это свойство больше не поддерживается. URL баннера среднего разрешения, который показывается на странице канала в мобильных приложениях. Максимальный размер изображения – 960 x 263 пкс.
brandingSettings.image.bannerMobileHdImageUrl	string Это свойство больше не поддерживается. URL баннера с высоким разрешением, который показывается на странице канала в мобильных приложениях. Максимальный размер изображения – 1280 x 360 пкс.
brandingSettings.image.bannerMobileExtraHdImageUrl	string Это свойство больше не поддерживается. URL баннера очень высокого разрешения, который показывается на странице канала в мобильных приложениях. Максимальный размер изображения – 1440 x 395 пкс.
brandingSettings.image.bannerTvImageUrl	string Это свойство больше не поддерживается. URL баннера со сверхвысоким разрешением, который показывается на странице канала в приложениях для телевизоров. Максимальный размер изображения – 2120 x 1192 пикселя.
brandingSettings.image.bannerTvLowImageUrl	string Это свойство больше не поддерживается. URL баннера с низким разрешением, который показывается на странице канала в приложениях для телевизоров. Максимальный размер изображения – 854 x 480 пкс.
brandingSettings.image.bannerTvMediumImageUrl	string Это свойство больше не поддерживается. URL баннера среднего разрешения, который показывается на странице канала в приложениях для телевизоров. Максимальный размер изображения – 1280 x 720 пкс.
brandingSettings.image.bannerTvHighImageUrl	string Это свойство больше не поддерживается. URL баннера с высоким разрешением, который показывается на странице канала в приложениях для телевизоров. Максимальный размер изображения – 1920 x 1080 пикселей.
brandingSettings.image.bannerExternalUrl	string Это свойство указывает на местоположение изображения, которое YouTube использует для создания баннеров разных размеров.
brandingSettings.hints[]	list Это свойство и все его дочерние свойства больше не поддерживаются. Объект hints содержит дополнительные свойства брендинга.
brandingSettings.hints[].property	string Это свойство больше не поддерживается. Ресурс.
brandingSettings.hints[].value	string Это свойство больше не поддерживается. Значение свойства.
auditDetails	object Объект auditDetails содержит данные о канале, которые многоканальная сеть (МКС) оценивает, чтобы принять решение о том, принимать ли канал в сеть. Обратите внимание, что любой запрос к API, который извлекает эту часть ресурса, должен содержать токен авторизации с областью действия https://www.googleapis.com/auth/youtubepartner-channel-audit. Кроме того, любой токен, использующий эту область действия, должен быть отозван, когда МКС решит принять или отклонить канал, или в течение двух недель с даты выпуска токена.
auditDetails.overallGoodStanding	boolean В этом поле указано, есть ли проблемы с каналом. В настоящее время это поле представляет собой результат логической операции AND над свойствами communityGuidelinesGoodStanding, copyrightStrikesGoodStanding и contentIdClaimsGoodStanding. Это означает, что данное свойство имеет значение true, если все остальные свойства также имеют значение true. Однако если хотя бы одно из этих свойств имеет значение false, то и у этого свойства будет значение false. Однако обратите внимание, что методология, используемая для установки значения этого свойства, может измениться.
auditDetails.communityGuidelinesGoodStanding	boolean Указывает, соблюдаются ли на канале правила сообщества YouTube.
auditDetails.copyrightStrikesGoodStanding	boolean Указывает, есть ли на канале предупреждения о нарушении авторских прав.
auditDetails.contentIdClaimsGoodStanding	boolean Указывает, есть ли на канале неразрешенные заявки.
contentOwnerDetails	object Объект contentOwnerDetails содержит данные канала, которые видны только партнеру YouTube, связавшему канал со своей системой управления контентом.
contentOwnerDetails.contentOwner	string Идентификатор владельца контента, связанного с каналом.
contentOwnerDetails.timeLinked	datetime Дата и время, когда канал был связан с владельцем контента. Значение указывается в формате ISO 8601.
localizations	object Объект localizations содержит переводы метаданных канала.
localizations.(key)	object Язык локализованных метаданных, связанных с парой "ключ-значение". Значение представляет собой строку, содержащую код языка BCP-47.
localizations.(key).title	string Локализованное название канала.
localizations.(key).description	string Локализованное описание канала.