ChannelSections

channelSection 资源包含一组 与频道精选的视频进行比较例如，版块可以推介某个频道的 最新上传的视频、最热门的上传视频或一个或多个播放列表中的视频。

一个频道最多可以创建 10 个频道架。

方法

对于 channelSections 资源，该 API 支持以下方法：

list
返回符合 API 请求条件的 channelSection 资源列表。 立即试用。
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 用来唯一标识频道版块的 ID。
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
在频道版块中展示的一个或多个播放列表 ID 的列表。如果 channelSection 资源的 snippet.type 属性为 singlePlaylist 或 multiplePlaylists，您必须指定播放列表 ID 列表，并且不应为其他类型的版块指定此属性。如果类型为 singlePlaylist，则此列表只能指定一个播放列表 ID。
contentDetails.channels[] list
频道版块中展示的一个或多个频道 ID 的列表。如果 channelSection 资源的 snippet.type 属性为 multipleChannels，则您必须指定频道 ID 列表，并且不应为其他类型的版块指定此属性。您不能在列表中添加自己的频道。