channelSection
资源包含有关频道已选择推介的一组视频的信息。例如,版块可以展示频道最新上传的内容、最热门上传的视频,以及来自一个或多个播放列表的视频。
一个渠道最多可以创建 10 个书架。
方法
该 API 支持 channelSections
资源的以下方法:
资源表示法
以下 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 频道版块的类型。 此属性的有效值包括:
|
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 列表,并且不应为其他类型的版块指定此属性。您不能将自己的频道加入列表。 |