ChannelSections

channelSection 资源包含有关频道已选择推介的一组视频的信息。例如,版块可以展示频道最新上传的内容、最热门上传的视频,以及来自一个或多个播放列表的视频。

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

方法

该 API 支持 channelSections 资源的以下方法:

list
返回与 API 请求条件匹配的 channelSection 资源列表。 立即试用
插入
将频道部分添加到经过身份验证的用户的频道。一个渠道最多可以创建 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 值为 multiplePlaylistsmultipleChannels 的频道版块的标题,实际上,在插入或更新其中任一版块类型时,您都必须指定标题。如果您为其他类型的频道版块指定标题,则此值将被忽略。

此属性的值不得超过 100 个字符,且可能包含 <> 以外的所有有效 UTF-8 字符。
snippet.position unsigned integer
该部分在频道页中的位置。此属性使用从 0 开始的索引。值 0 表示频道上显示的第一个部分,值 1 表示第二个部分,以此类推。

如果您在插入频道部分时没有为此属性指定值,则默认行为是最后显示新部分。
contentDetails object
contentDetails 对象包含频道版块内容的详细信息,例如版块中的播放列表或频道列表。
contentDetails.playlists[] list
频道版块中显示的一个或多个播放列表 ID 的列表。如果 channelSection 资源的 snippet.type 属性为 singlePlaylistmultiplePlaylists,则必须指定播放列表 ID 列表,并且不应为其他类型的版块指定此属性。如果类型为 singlePlaylist,此列表必须且只能指定一个播放列表 ID。
contentDetails.channels[] list
频道部分中由一个或多个频道 ID 组成的列表。如果 channelSection 资源的 snippet.type 属性为 multipleChannels,则必须指定频道 ID 列表,并且不应为其他类型的版块指定此属性。您不能将自己的频道加入列表。