实现：渠道

本页面介绍了如何使用 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。该 ID 可以从第 1 步中的 API 响应中提取。
    • 将 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"
    }
  }
}

    如需在 APIs 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

如果您不使用 channelId 参数，而是将 mine 参数值设置为 true，则此请求需要授权。该参数表示您要检索当前经过身份验证的用户的频道的频道版块。

上传并设置频道的视频水印图片

您可以调用 watermarks.set 方法来上传水印图片并将其设置为频道的视频水印。然后，该图片会在指定频道的视频播放期间显示。您还可以指定该图片将链接到的目标频道，以及确定水印显示时间和显示时长的时序详细信息。

watermarks.unset 方法会删除频道的视频水印图片。

遗憾的是，您无法使用 APIs Explorer 测试此查询，因为 APIs Explorer 不支持上传媒体文件的功能，而此方法需要此功能。