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 清單，而且不得為其他區段指定這個屬性。您不能將自己的頻道加入清單中。