實作：管道

本頁說明如何使用 YouTube Data API (v3) 執行與擷取及更新頻道資料相關的功能。channel 資源包含播放清單 ID，可用於識別頻道上傳和喜歡的影片。如要在呼叫 channels.list 方法時擷取這項資訊，請確認 part 參數值包含 contentDetails 資源部分。

擷取管道相關資訊

呼叫 channels.list 方法，擷取特定管道的相關資訊。你可以透過以下幾種方式辨識頻道：

設定頻道的品牌資訊

這個範例會更新頻道的品牌宣傳元素選項。這個範例有兩個步驟：

  • 步驟 1：擷取頻道的品牌宣傳內容選項

    呼叫 channels.list 方法，並將 part 參數值設為 brandingSettings，將 mine 參數值設為 true。

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    應用程式可以顯示擷取的設定，讓使用者修改設定以進行更新。

  • 步驟 2：更新頻道的品牌宣傳選項

    呼叫 channels.list 方法並設定以下值：

    • 將 id 屬性設為頻道的專屬 YouTube 頻道 ID。您可以在步驟 1 中從 API 回應中擷取 ID。
    • 將 part 參數值設為 brandingSettings。

    下方 API Explorer 連結會建立 channel 資源，並採用下列品牌設定：

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    如要在 API Explorer 中完成要求，您必須將 id 屬性的值設為已驗證使用者頻道的頻道 ID。您也應將圖片屬性設為與目前設定相符。

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

管理頻道版面

這個 API 支援 channelSections.list、channelSections.insert、channelSections.update 和 channelSections.delete 方法，可用於管理頻道版面。頻道版面是一組頻道上收錄的影片。舉例來說，專區可以包含頻道的最新上傳內容、最熱門上傳內容，或是一或多個播放清單的影片。

以下範例會擷取 Google 官方 YouTube 頻道的頻道版面。要求會呼叫 channelSections.list 方法，並將 channelId 參數值設為 UCK8sQmJBp8GCxrOtXWBpyEA，這是 Google 管道的管道 ID。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

如果您將 mine 參數值設為 true，而非使用 channelId 參數，則這項要求必須經過授權。這個參數表示您要擷取目前已驗證使用者頻道的頻道版面。

上傳並設定頻道的浮水印圖片

您可以呼叫 watermarks.set 方法，上傳浮水印圖片並為頻道設定浮水印。系統會在播放指定頻道的影片時顯示這張圖片。您也可以指定圖片連結的目標管道，以及決定浮水印顯示時間和顯示時間長度的時間詳細資料。

watermarks.unset 方法會刪除頻道的浮水印圖片。

很抱歉，這個查詢無法使用 APIs Explorer 進行測試，因為 APIs Explorer 不支援上傳媒體檔案，而這正是此方法的必要條件。