Channels

Теперь API поддерживает возможность помечать ваш канал или видео как «предназначенные для детей». Кроме того, ресурсы channel и video теперь также содержат свойство, указывающее на статус «предназначенный для детей» этого канала или видео. Условия использования и политика разработчиков сервисов YouTube API также были обновлены 10 января 2020 года. Для получения дополнительной информации см. историю изменений сервиса YouTube Data API и условия использования сервисов 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. Например, ваше приложение не должно использовать домен http вместо домена https в URL-адресе, возвращаемом в ответе API.

URL-адреса миниатюр каналов доступны только в домене https , именно так они отображаются в ответах API. В вашем приложении могут отображаться неработающие изображения, если оно попытается загрузить изображения YouTube из домена http . Миниатюры новых каналов могут быть пустыми, и их заполнение может занять до одного дня.
snippet.thumbnails. (key) object
Допустимые значения ключей:
  • default — изображение-миниатюра по умолчанию. Миниатюра по умолчанию для видео — или ресурса, ссылающегося на видео, например, элемента плейлиста или результата поиска — имеет ширину 120 пикселей и высоту 90 пикселей. Миниатюра по умолчанию для канала имеет ширину 88 пикселей и высоту 88 пикселей.
  • medium – версия миниатюрного изображения с более высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей.
  • high – версия миниатюрного изображения с высоким разрешением. Для видео (или ресурса, ссылающегося на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 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 для добавления или удаления элементов из этого списка.

Обратите внимание, что YouTube прекратил поддержку функции добавления видео в избранное. Например, свойство statistics.favoriteCount ресурса video было объявлено устаревшим 28 августа 2015 года. В результате, по историческим причинам, значение этого свойства может содержать идентификатор плейлиста, который ссылается на пустой плейлист и, следовательно, не может быть получен.
contentDetails.relatedPlaylists. uploads string
Идентификатор плейлиста, содержащего загруженные на канал видео. Используйте метод videos.insert для загрузки новых видео и метод videos.delete для удаления ранее загруженных видео.
statistics object
Объект statistics содержит статистические данные для канала.
statistics. viewCount unsigned long

Сумма общего количества просмотров всех видеороликов канала во всех форматах.

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

topicDetails. topicCategories[] list
Список ссылок на статьи Википедии, описывающие контент канала.
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 Analytics , который вы хотите использовать для отслеживания и измерения трафика на ваш канал.
brandingSettings.channel. unsubscribedTrailer string
Видео, которое должно воспроизводиться в модуле «Рекомендуемые видео» в режиме просмотра на странице канала для неподписанных зрителей. Подписанные зрители могут видеть другое видео, демонстрирующее более свежую активность канала.

Если указано иное, значение свойства должно представлять собой идентификатор видео на YouTube, являющегося общедоступным или закрытым видео, принадлежащим владельцу канала.
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. Размер изображения — 1060x175 пикселей.
brandingSettings.image. bannerMobileImageUrl string
Данный объект недвижимости устарел.

URL-адрес баннерного изображения, отображаемого на странице канала в мобильных приложениях. Размер изображения: 640 x 175 пикселей.
brandingSettings.image. watchIconImageUrl string
Данный объект недвижимости устарел.

URL изображения, которое отображается над видеоплеером. Это изображение высотой 25 пикселей с гибкой шириной, не превышающей 170 пикселей. Если вы не укажете это изображение, вместо него будет отображаться название вашего канала.
brandingSettings.image. trackingImageUrl string
Данный объект недвижимости устарел.

URL-адрес пикселя отслеживания размером 1x1 пиксель, который можно использовать для сбора статистики просмотров канала или страниц видео.
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 инкапсулирует данные канала, которые многоканальная сеть (MCN) будет оценивать при принятии решения о принятии или отклонении конкретного канала. Обратите внимание, что любой API-запрос, получающий эту часть ресурса, должен предоставлять токен авторизации, содержащий область действия https://www.googleapis.com/auth/youtubepartner-channel-audit . Кроме того, любой токен, использующий эту область действия, должен быть отозван, когда MCN примет решение о принятии или отклонении канала, или в течение двух недель с даты выдачи токена.
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
Локализованное описание канала.