实现：渠道

本页介绍了如何使用 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 方法用于删除频道的水印图片。

很遗憾，您无法使用 API Explorer 测试此查询，因为 API Explorer 不支持上传媒体文件，而这是此方法的要求。