ChannelSections

Ресурс channelSection содержит информацию о наборе видео, которые автор канала решил продвигать. Например, в разделе могут быть представлены последние или самые популярные видео, а также ролики из одного или нескольких плейлистов.

На канале может быть не более 10 разделов.

Методы

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

list
Возвращает список channelSection ресурсов, соответствующих критериям запроса к API. Попробовать
insert
Добавляет раздел на канал пользователя, прошедшего аутентификацию. На канале можно создать не более 10 разделов. Перейти
update
Обновляет раздел канала. Перейти
delete
Удаляет раздел канала. Перейти

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

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

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

Свойства

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

Свойства
kind string
Тип ресурса API. Значение будет youtube#channelSection.
etag etag
Тег Etag этого ресурса.
id string
Идентификатор, который YouTube использует для уникальной идентификации раздела канала.
snippet object
Объект snippet содержит основные сведения о разделе канала, например его тип и название.
snippet.type string
Тип раздела канала.

Допустимые значения этого свойства:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Идентификатор, который YouTube использует для уникальной идентификации канала, на котором опубликован раздел.
snippet.title string
Название раздела. Название можно задать только для разделов канала, у которых свойство snippet.type имеет значение multiplePlaylists или multipleChannels. При добавлении или обновлении разделов этих типов название указывать обязательно. Если вы укажете название для раздела другого типа, оно будет проигнорировано.

Значение этого свойства может содержать до 100 символов UTF-8, кроме < и >.
snippet.position unsigned integer
Положение раздела на странице канала. Индекс этого свойства начинается с нуля. Значение 0 соответствует первому разделу на канале, 1 – второму и т. д.

Если при добавлении раздела канала не указать значение этого свойства, режим работы по умолчанию — показывать новый раздел последним.
contentDetails object
Объект contentDetails содержит сведения о контенте раздела канала, например список плейлистов или каналов, представленных в разделе.
contentDetails.playlists[] list
Список идентификаторов одного или нескольких плейлистов, которые представлены в разделе канала. Если свойство snippet.type ресурса channelSection имеет значение singlePlaylist или multiplePlaylists, необходимо указать список идентификаторов плейлистов. Для других типов разделов это свойство указывать не нужно. Если тип – singlePlaylist, в списке должен быть указан только один идентификатор плейлиста.
contentDetails.channels[] list
Список идентификаторов каналов, которые представлены в разделе канала. Если свойство snippet.type ресурса channelSection имеет значение multipleChannels, необходимо указать список идентификаторов каналов. Для других типов разделов это свойство указывать не нужно. Нельзя добавить в список свой канал.