Ресурс 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 Тип раздела канала. Допустимые значения для этого свойства:
|
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 , и это свойство не должно указываться для других типов разделов. Вы не можете включить свой собственный канал в список. |