ChannelSections

channelSection 资源包含频道选择推介的一组视频的相关信息。例如，版块可以展示某个频道最新上传的视频、最热门的上传视频，或者一个或多个播放列表中的视频。

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

方法

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

list

返回符合 API 请求条件的 channelSection 资源列表。立即试用。

insert

向已通过身份验证的用户的频道添加频道部分。一个频道最多可以创建 10 个搁架。 立即试用。

update

更新频道版块。 立即试用。

删除

删除频道版块。 立即试用。

资源表示法

以下 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 用来唯一标识发布频道版块的频道的 ID。
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 列表，并且不应为其他类型的版块指定此属性。您不能在列表中添加自己的频道。