ChannelSections

channelSection 資源包含頻道選擇主打的一組影片相關資訊。舉例來說，「版面」可以是頻道最近上傳的影片、最受歡迎的上傳影片，或是一或多個播放清單中的影片。

一個頻道最多可以建立 10 個影片櫃。

方法

這個 API 支援下列 channelSections 資源方法：

list

傳回符合 API 要求條件的 channelSection 資源清單。立即試用。

插入

在已驗證使用者的頻道中新增頻道版面。每個頻道最多可以建立 10 個影片櫃。 立即試用。

更新

更新頻道版面。 立即試用。

刪除

刪除頻道版面。 立即試用。

資源表示法

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