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

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