channelSection
资源包含频道选择推介的一组视频的相关信息。例如,版块可以展示某个频道最新上传的视频、最热门的上传视频,或者一个或多个播放列表中的视频。
一个频道最多可以创建 10 个搁架。
方法
对于 channelSections
资源,该 API 支持以下方法:
资源表示法
以下 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 用来唯一标识发布频道版块的频道的 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 列表,并且不应为其他类型的版块指定此属性。您不能在列表中添加自己的频道。 |