Channels

现在，该 API 支持标记您的频道或 视频归类为“面向儿童的内容”。此外，channel 还有 video 项资源现在也包含一个用于标识“面向儿童的内容”的属性 频道或视频的状态YouTube API 服务的服务条款和开发者政策 也于 2020 年 1 月 10 日更新。有关详细信息，请参阅 YouTube Data API 服务和 YouTube API 服务的服务条款。

channel 资源包含有关 YouTube 频道的信息。

方法

对于 channels 资源，该 API 支持以下方法：

list

返回符合请求条件的零个或零个以上 channel 资源的集合。 立即试用。

update

更新频道的元数据。请注意，此方法目前仅支持更新 channel 资源的 brandingSettings 和 invideoPromotion 对象及其子属性。 立即试用。

资源表示法

以下 JSON 结构显示了 channels 资源的格式：

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

属性

下表定义了此资源中显示的属性：

属性
kind	string 用于标识 API 资源的类型。其值将为 youtube#channel。
etag	etag 此资源的 Etag。
id	string YouTube 用来唯一标识频道的 ID。
snippet	object snippet 对象包含有关频道的基本详情，例如标题、说明和缩略图。
snippet.title	string 频道的标题。
snippet.description	string 频道的说明。属性值的长度上限为 1000 个字符。
snippet.customUrl	string 频道的自定义网址。YouTube 帮助中心介绍了获取自定义网址的资格要求以及如何设置自定义网址。
snippet.publishedAt	datetime 频道的创建日期和时间。该值采用 ISO 8601 格式。
snippet.thumbnails	object 与频道相关联的缩略图的地图。对于地图中的每个对象，键即为缩略图的名称，值为包含有关缩略图的其他信息的对象。 在应用中显示缩略图时，请确保您的代码使用的图片网址与 API 响应中返回的图片网址完全一致。例如，在 API 响应中返回的网址中，您的应用不应使用 http 网域，而不应使用 https 网域。 频道缩略图网址只能在 https 网域中使用，这也是网址在 API 响应中的显示方式。如果应用尝试从 http 网域加载 YouTube 图片，您可能会在应用中看到损坏的图片。对于新创建的频道，缩略图图片可能为空，且最多可能需要一天时间才能填充完毕。
snippet.thumbnails.(key)	object 有效的关键值包括： default - 默认缩略图。视频的默认缩略图或引用视频的资源（例如播放列表项或搜索结果）为 120 像素宽，90 像素高。频道的默认缩略图宽度为 88 像素，高度为 88 像素。 medium - 分辨率更高的缩略图版本。对于视频（或引用视频的资源），此图片的宽度为 320 像素，高度为 180 像素。对于频道来说，该图片的宽度为 240 像素，高度为 240 像素。 high - 高分辨率版本的缩略图。对于视频（或引用视频的资源），此图片的宽度为 480 像素，高度为 360 像素。对于频道来说，该图片宽 800 像素，高 800 像素。
snippet.thumbnails.(key).url	string 图片的网址。如需了解有关在应用中使用缩略图网址的其他准则，请参阅 snippet.thumbnails 属性定义。
snippet.thumbnails.(key).width	unsigned integer 图片的宽度。
snippet.thumbnails.(key).height	unsigned integer 图片的高度。
snippet.defaultLanguage	string channel 资源的 snippet.title 和 snippet.description 属性中的文本语言。
snippet.localized	object snippet.localized 对象包含频道的本地化标题和说明，或者包含频道元数据的默认语言的频道标题和说明。 如果 channels.list 请求使用 hl 参数指定系统应返回哪些本地化文本的语言，hl 参数值会标识一种 YouTube 应用语言，并且本地化文本能够以该语言提供，那么系统会在资源代码段中返回本地化文本。 如果未指定 hl 参数值，或者指定了值但指定语言没有本地化元数据，则返回默认语言的元数据。 该属性包含只读值。使用 localizations 对象添加、更新或删除本地化元数据。
snippet.localized.title	string 本地化的频道标题。
snippet.localized.description	string 本地化的频道说明。
snippet.country	string 频道所关联的国家/地区。如需设置此属性的值，请更新 brandingSettings.channel.country 属性的值。
contentDetails	object contentDetails 对象用于封装有关频道内容的信息。
contentDetails.relatedPlaylists	object relatedPlaylists 对象是用于标识与频道相关联的播放列表（例如频道中上传的视频或赞过的视频）的映射。您可以使用 playlists.list 方法检索所有这些播放列表。
contentDetails.relatedPlaylists.likes	string 包含频道所赞视频的播放列表的 ID。使用 playlistItems.insert 和 playlistItems.delete 方法向该列表中添加或移除项。
contentDetails.relatedPlaylists.favorites	string 此属性已弃用。 包含频道收藏视频的播放列表的 ID。使用 playlistItems.insert 和 playlistItems.delete 方法可在该列表中添加或移除项目。 请注意，YouTube 已弃用收藏视频功能。例如，video 资源的 statistics.favoriteCount 属性已于 2015 年 8 月 28 日弃用。因此，由于历史原因，此属性值可能包含引用了空播放列表的播放列表 ID，因此无法提取。
contentDetails.relatedPlaylists.uploads	string 包含频道所上传视频的播放列表的 ID。使用 videos.insert 方法上传新视频，使用 videos.delete 方法删除之前上传的视频。
statistics	object statistics 对象可封装频道的统计信息。
statistics.viewCount	unsigned long 频道的观看次数。
statistics.commentCount	unsigned long 此属性已弃用。 频道的评论数。
statistics.subscriberCount	unsigned long 频道订阅人数。该值向下舍入为三 重要数字。请参阅 修订历史记录或 如需了解详情，请访问 YouTube 帮助中心 有关订阅人数如何舍入的详细信息。
statistics.hiddenSubscriberCount	boolean 指明频道的订阅人数是否公开显示。
statistics.videoCount	unsigned long 上传到频道的公开视频数量。请注意，该值反映的是 频道中的公开视频，甚至是所有者。此行为与计数一致 出现在 YouTube 网站上
topicDetails	object topicDetails 对象可封装与频道关联的主题的相关信息。 重要提示：如需详细了解与主题 ID 相关的变更，请参阅 topicDetails.topicIds[] 属性定义和修订历史记录。
topicDetails.topicIds[]	list 与频道相关联的主题 ID 列表。 此属性自 2016 年 11 月 10 日起已弃用。我们将一直提供支持，直到 2017 年 11 月 10 日为止。 重要提示：由于 Freebase 和 Freebase API 的弃用情况，自 2017 年 2 月 27 日起，主题 ID 的运作方式开始发生变化。那时，YouTube 开始返回一小部分精选主题 ID。 <ph type="x-smartling-placeholder"> </ph> 查看自 2017 年 2 月 15 日起支持的主题 ID 主题 音乐主题 /m/04rlf 音乐（父级主题） /m/02mscn 基督教音乐 /m/0ggq0m 古典音乐 /m/01lyv 国家/地区 /m/02lkt 电子音乐 /m/0glt670 嘻哈音乐 /m/05rwpb 独立音乐 /m/03_d0 爵士乐 /m/028sqc 亚洲音乐 /m/0g293 拉丁美洲音乐 /m/064t9 流行音乐 /m/06cqb 雷鬼乐 /m/06j6l 节奏布鲁斯 /m/06by7 摇滚乐 /m/0gywn 灵魂音乐 游戏主题 /m/0bzvm2 游戏（父级主题） /m/025zzc 动作游戏 /m/02ntfj 动作冒险游戏 /m/0b1vjn 休闲游戏 /m/02hygl 音乐类视频游戏 /m/04q1x3q 益智类视频游戏 /m/01sjng 赛车视频游戏 /m/0403l3g 角色扮演类视频游戏 /m/021bp2 模拟视频游戏 /m/022dc6 体育游戏 /m/03hf_rm 策略视频游戏 体育主题 /m/06ntj 体育（父级主题） /m/0jm_ 橄榄球 /m/018jz 棒球 /m/018w8 篮球 /m/01cgz 拳击 /m/09xp_ 板球 /m/02vx4 美式足球 /m/037hz 高尔夫 /m/03tmr 冰球 /m/01h7lh 综合格斗 /m/0410tth 赛车运动 /m/07bs0 网球 /m/07_53 排球 娱乐主题 /m/02jjt 娱乐（父级主题） /m/09kqc 幽默 /m/02vxn 电影 /m/05qjc 表演艺术 /m/066wd 职业摔跤 /m/0f2f9 电视节目 生活时尚主题 /m/019_rr 生活方式（父级主题） /m/032tl 时尚 /m/027x7n 健身 /m/02wbm 食品 /m/03glg 爱好 /m/068hy 宠物 /m/041xxh 身体魅力 [美妆] /m/07c1v 技术 /m/07bxq 旅游 /m/07yv9 交通工具 社会主题 /m/098wr 社会（父级主题） /m/09s1f 企业 /m/0kt51 健康 /m/01h6rj 军事 /m/05qt0 政治 /m/06bvp 宗教 其他主题 /m/01k8wb 知识
topicDetails.topicCategories[]	list 描述频道内容的维基百科网址列表。
status	object status 对象可封装有关频道隐私状态的信息。
status.privacyStatus	string 频道的隐私状态。 此媒体资源的有效值包括： private public unlisted
status.isLinked	boolean 指明频道数据是否标识了已经与 YouTube 用户名或 Google+ 账号相关联的用户。拥有其中一个链接的用户已经拥有公开的 YouTube 身份，这是执行某些操作（如上传视频）的前提条件。
status.longUploadsStatus	string 指明频道是否可以上传时长超过 15 分钟的视频。只有在频道所有者授权了 API 请求时，系统才会返回此属性。如需详细了解此功能，请访问 YouTube 帮助中心。 此属性的有效值包括： allowed – 此频道可以上传时长超过 15 分钟的视频。 disallowed – 此频道无法或无法上传时长超过 15 分钟的视频。频道必须严格遵守 YouTube 社区准则、信誉良好，并且内容没有在全球范围内遭到 Content ID 禁播。 频道所有者解决导致频道无法上传较长视频的问题后，该频道将恢复为 allowed 或 eligible 状态。 eligible – 此频道可以上传时长超过 15 分钟的视频。但是，频道所有者必须先在 https://www.youtube.com/verify 启用上传较长视频的功能。如需详细了解此功能，请访问 YouTube 帮助中心。
status.madeForKids	boolean 此值用于指明该频道是否被标识为面向儿童，并且包含 目前的“面向儿童的内容”频道的状态例如，状态可能是 取决于 selfDeclaredMadeForKids 属性的值。请参阅 如需了解详情，请访问 YouTube 帮助中心 了解有关为频道、视频或广播设置观众群的信息。
status.selfDeclaredMadeForKids	boolean 在 channels.update 请求中， 此属性可以让频道所有者将频道指定为面向儿童的频道。通过 只有在渠道所有者授权了 API 请求时，才会返回 属性值。
brandingSettings	object brandingSettings 对象用于封装频道品牌信息。
brandingSettings.channel	object channel 对象用于封装频道页的品牌属性。
brandingSettings.channel.title	string 频道的标题。标题的长度上限为 30 个字符。
brandingSettings.channel.description	string 频道说明，显示在您的频道页的频道信息框中。属性值的长度上限为 1000 个字符。
brandingSettings.channel.keywords	string 与你的频道相关的关键字。该值是一个以空格分隔的字符串列表。频道 如果关键字超过 500 个字符的长度上限，则可能会被截断 如果它们包含未转义的引号 (")，则会发生此错误。请注意，500 个字符的 限制并不是针对每个关键字的限制，而是对所有关键字的总长度的限制。
brandingSettings.channel.trackingAnalyticsAccountId	string 您要用于跟踪和衡量频道流量的 Google Analytics 账号的 ID。
brandingSettings.channel.unsubscribedTrailer	string 对于未订阅的观看者，应在频道页浏览视图的精选视频模块中播放的视频。订阅的观看者可能会看到其他重点展示近期频道活动的视频。 如果指定，则此属性的值必须是频道所有者拥有的公开或不公开列出的视频的 YouTube 视频 ID。
brandingSettings.channel.defaultLanguage	string channel 资源的 snippet.title 和 snippet.description 属性中的文本语言。
brandingSettings.channel.country	string 频道所关联的国家/地区。更新此属性以设置 snippet.country 属性的值。
brandingSettings.watch	object 注意：此对象及其所有子属性均已弃用。 watch 对象可封装频道视频的观看页面的品牌属性。
brandingSettings.watch.textColor	string 注意：此属性已弃用。 视频观看页面品牌区域的文字颜色。
brandingSettings.watch.backgroundColor	string 注意：此属性已弃用。 视频观看页面品牌区域的背景颜色。
brandingSettings.watch.featuredPlaylistId	string 注意：此属性已弃用。如果您尝试设置其值，API 会返回错误。
brandingSettings.image	object 此属性及其所有子属性均已弃用。 image 对象可封装频道的频道页或视频观看页面上显示的图片的相关信息。
brandingSettings.image.bannerImageUrl	string 此属性已弃用。 YouTube 网站的频道页上显示的横幅图片的网址。图片尺寸为 1060x175 像素。
brandingSettings.image.bannerMobileImageUrl	string 此属性已弃用。 移动应用中频道页上显示的横幅图片的网址。图片尺寸为 640x175 像素。
brandingSettings.image.watchIconImageUrl	string 此属性已弃用。 视频播放器上方显示的图片网址。此图片高度为 25 像素，宽度不固定（不得超过 170 像素）。如果您没有提供此图片，则会显示您的频道名称，而不是图片。
brandingSettings.image.trackingImageUrl	string 此属性已弃用。 1x1 跟踪像素的网址，该跟踪像素可用于收集关于频道或视频页的观看次数的统计信息。
brandingSettings.image.bannerTabletLowImageUrl	string 此属性已弃用。 在平板电脑应用的频道页上显示的低分辨率横幅图片的网址。图片的尺寸上限为 1138 x 188 像素。
brandingSettings.image.bannerTabletImageUrl	string 此属性已弃用。 在平板电脑应用的频道页上显示的横幅图片的网址。图片尺寸为 1707 x 283 像素。
brandingSettings.image.bannerTabletHdImageUrl	string 此属性已弃用。 平板电脑应用中频道页上显示的高分辨率横幅图片的网址。图片的尺寸上限为 2276 x 377 像素。
brandingSettings.image.bannerTabletExtraHdImageUrl	string 此属性已弃用。 在平板电脑应用的频道页上显示的超高分辨率横幅图片的网址。图片的尺寸上限为 2560x424 像素。
brandingSettings.image.bannerMobileLowImageUrl	string 此属性已弃用。 在移动应用的频道页上显示的低分辨率横幅图片的网址。图片的尺寸上限为 320x88 像素。
brandingSettings.image.bannerMobileMediumHdImageUrl	string 此属性已弃用。 在移动应用的频道页上显示的中等分辨率横幅图片的网址。图片的尺寸上限为 960x263 像素。
brandingSettings.image.bannerMobileHdImageUrl	string 此属性已弃用。 在移动应用的频道页上显示的高分辨率横幅图片的网址。图片的尺寸上限为 1280x360 像素。
brandingSettings.image.bannerMobileExtraHdImageUrl	string 此属性已弃用。 移动应用的频道页上显示的极高分辨率横幅图片的网址。图片的尺寸上限为 1440x395 像素。
brandingSettings.image.bannerTvImageUrl	string 此属性已弃用。 在电视应用的频道页上显示的超高分辨率横幅图片的网址。图片的尺寸上限为 2120 x 1192 像素。
brandingSettings.image.bannerTvLowImageUrl	string 此属性已弃用。 在电视应用的频道页上显示的低分辨率横幅图片的网址。图片的尺寸上限为 854 x 480 像素。
brandingSettings.image.bannerTvMediumImageUrl	string 此属性已弃用。 在电视应用的频道页上显示的中等分辨率横幅图片的网址。图片的尺寸上限为 1280x720 像素。
brandingSettings.image.bannerTvHighImageUrl	string 此属性已弃用。 在电视应用的频道页上显示的高分辨率横幅图片的网址。图片的尺寸上限为 1920x1080 像素。
brandingSettings.image.bannerExternalUrl	string 该属性指定 YouTube 用来生成视频的横幅图片的位置 频道的各种横幅图片尺寸
brandingSettings.hints[]	list 此属性及其所有子属性已被弃用。 hints 对象用于封装其他品牌属性。
brandingSettings.hints[].property	string 此属性已弃用。 属性。
brandingSettings.hints[].value	string 此属性已弃用。 属性的值。
auditDetails	object auditDetails 对象用于封装多频道网络 (MCN) 在确定是接受还是拒绝特定频道时所评估的频道数据。请注意，任何检索此资源部分的 API 请求都必须提供包含 https://www.googleapis.com/auth/youtubepartner-channel-audit 范围的授权令牌。此外，多频道网络决定接受或拒绝频道后，或在令牌发放之日起两周内，必须撤消使用这种范围的令牌。
auditDetails.overallGoodStanding	boolean 此字段用于指明频道是否存在任何问题。目前，此字段表示对 communityGuidelinesGoodStanding、copyrightStrikesGoodStanding 和 contentIdClaimsGoodStanding 属性执行逻辑 AND 运算的结果，这意味着，如果所有其他属性的值也为 true，则该属性的值为 true。不过，如果其中任一属性的值为 false，则此属性的值将是 false。但请注意，用于设置此属性值的方法可能会发生变化。
auditDetails.communityGuidelinesGoodStanding	boolean 指明频道是否遵守 YouTube 的《社区准则》。
auditDetails.copyrightStrikesGoodStanding	boolean 指明频道是否收到了版权警示。
auditDetails.contentIdClaimsGoodStanding	boolean 指明频道是否有任何未解决的版权主张。
contentOwnerDetails	object contentOwnerDetails 对象用于封装只有将频道关联至内容管理器的 YouTube 合作伙伴才能看到的频道数据。
contentOwnerDetails.contentOwner	string 与频道相关联的内容所有者的 ID。
contentOwnerDetails.timeLinked	datetime 频道与内容所有者关联的日期和时间。该值采用 ISO 8601 格式。
localizations	object localizations 对象用于封装频道元数据的翻译。
localizations.(key)	object 与键值关联的本地化元数据的语言。该值是一个包含 BCP-47 语言代码的字符串。
localizations.(key).title	string 本地化的频道标题。
localizations.(key).description	string 本地化的频道说明。