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 值的 multiplePlaylistsmultipleChannels 值的頻道版面標題;事實上,當您插入或更新這兩種類型的版面時,必須指定一個標題。如果為其他類型的頻道區段指定標題,系統會忽略該值。

這個屬性的值長度上限為 100 個字元,並包含所有有效的 UTF-8 字元,但 <> 除外。
snippet.position unsigned integer
該版面在頻道頁面上的位置。此屬性使用以 0 為基礎的索引。0 值可識別顯示在頻道的第一個區段,1 值則可用來識別第二個部分,依此類推。

如果您在插入頻道版面時未指定這個屬性的值,則預設行為是將新區段設為最後顯示。
contentDetails object
contentDetails 物件包含頻道版面內容的詳細資料,例如該版面收錄的播放清單或頻道。
contentDetails.playlists[] list
頻道版面中顯示的一或多個播放清單 ID 清單。如果 channelSection 資源的 snippet.type 屬性為 singlePlaylistmultiplePlaylists,且您不應為其他類型的區段指定這個屬性,則必須指定播放清單 ID 清單。如果類型為 singlePlaylist,此清單必須指定一個播放清單 ID。
contentDetails.channels[] list
頻道專區中顯示的一或多個頻道 ID 清單。如果 channelSection 資源的 snippet.type 屬性為 multipleChannels,且不得為其他類型的部分指定這個屬性,則必須指定頻道 ID 清單。您無法在清單中加入自己的頻道。