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 清單。您無法在清單中加入自己的頻道。 |