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
Этаг этого ресурса.
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. Значение 0 идентифицирует первый раздел, который появляется в канале, значение 1 идентифицирует второй раздел и т. д.

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