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 用來識別發布頻道版面的頻道 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 清單,而且不應為其他類型的版面指定這個屬性。你無法將自己的頻道加入清單。 |