YouTube Analytics API: Channel Reports

本页列出了频道所有者可以通过 YouTube Analytics API 获取的报告。频道报告提供指定频道的用户活动指标，并衡量视频观看次数、评分和订阅次数等指标。

  • 视频报告提供与频道的视频相关的所有用户活动的统计信息。
  • 播放列表报告提供与播放列表中的视频观看次数特别相关的统计信息。

  • 广告效果报告包含与收入和广告效果相关的指标。它们使用 adType 维度，根据视频播放期间投放的广告类型对指标进行分组。广告效果报告部分介绍了该 API 支持的两种广告效果指标。

检索报告

如需检索渠道报告，您必须将 API 请求中的 ids 参数值设置为以下值之一：

  • channel==MINE - API 返回经过身份验证的用户的 YouTube 频道的数据。

  • channel==CHANNEL_ID - 将 CHANNEL_ID 设置为您要检索数据的频道的唯一频道 ID。对请求授权的用户必须是频道的所有者。

    目前，频道 ID 是一个以字母 UC 开头的字符串，但其格式可能会发生变化。（您可以在 YouTube 频道的高级帐号设置页面查找频道 ID，也可以使用 YouTube Data API's channels.list 方法以编程方式检索频道 ID。）

授权

所有 YouTube Analytics API 请求都必须经过授权。授权指南介绍了如何使用 OAuth 2.0 协议获取授权令牌。

YouTube Analytics API 请求使用以下授权范围：

作用域
https://www.googleapis.com/auth/yt-analytics.readonly 查看 YouTube 分析工具为您的 YouTube 内容出具的报告。此范围可提供对用户活动指标的访问权限，例如观看次数和评分次数。
https://www.googleapis.com/auth/yt-analytics-monetary.readonly 查看 YouTube 分析工具为您的 YouTube 内容出具的财务报表。此范围可提供对用户活动指标以及估算收入和广告效果指标的访问权限。
https://www.googleapis.com/auth/youtube 管理你的 YouTube 账号。在 YouTube Analytics API 中，频道所有者使用此范围来管理 YouTube 数据分析组和组项目。
https://www.googleapis.com/auth/youtubepartner 在 YouTube 上查看和管理 YouTube 资产和相关内容。在 YouTube Analytics API 中，内容所有者使用此范围来管理 YouTube 数据分析组和组项目。

注意：频道报告目前不支持估算收入和广告效果指标。因此，https://www.googleapis.com/auth/yt-analytics-monetary.readonly 范围目前不授予对这些报告中的货币数据的访问权限。

滤镜

以下表格介绍了支持的报告，其中明确了可用于每个报告的过滤器。在表格中，括号中显示的过滤条件是可选的。例如，对于过滤选项 video(,country)，视频过滤条件为必需，国家/地区过滤条件为可选。

该 API 还支持为 video 和 playlist 过滤条件指定多个值。如果您确实为其中一个过滤条件指定了多个值，则也可以将该过滤条件添加到您为请求指定的维度列表中。即使相应过滤条件没有列为特定报告支持的维度，也是如此。

有关如何针对特定值或一组值过滤 API 结果的完整说明，请参阅 filters 参数定义。

了解报告表格

本部分介绍了在定义 API 支持的报告时使用的表格中使用的格式和术语。下表列出了使用时间维度和 averageViewPercentage 指标的播放详情视频报告支持的维度、指标和过滤条件。

内容
尺寸：
使用 0 或更多值 creatorContentType、subscribedStatus、youtubeProduct
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 subscribedStatus、youtubeProduct

此表格包含两行维度、一行指标和三行过滤条件。对于维度和过滤条件，每行的值都可以在 API 请求中合并，前提是组合遵循表中的使用规则。例如，此报告的有效 dimensions 参数值包括：

  • dimensions=day
  • dimensions=day,liveOrOnDemand
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

不过，参数值 day,month 无效，因为它使用两个基于时间的维度，但请求可以使用 0 或 1。在这种情况下，参数值 subscribedStatus,youtubeProduct 实际上会返回一个报告，但指标不会按天、周、月等方式汇总（文档中单独记录了该报告）。

报告表格术语

表格使用以下术语来表示维度是必需维度还是可选维度：

  • 这些术语表示必须提供一个值：
    • 必需：您必须添加该值。
    • 仅使用 1：您必须添加值组中的一个值。
    • 使用 1 个或多个值：您可以添加组中的任意值或所有值，但必须至少包含一个值。
  • 以下术语表示值是可选的：
    • 可选：您可以选择添加值。
    • 使用 0 或 1：您可以选择添加组中的一个值。
    • 使用 0 或更大值：您可以选择添加组中的任意值或所有值。

视频报告

基本统计数据

基本用户活动统计信息

该报告会提供用户在某个频道上所执行操作的相关统计信息。您可以对报告进行过滤，仅返回特定视频或国家/地区的数据。

内容
尺寸：
[无]
指标：
使用 1 项或更多 views,redViews,comment3Revenue{6annotation3,当返回。{6{6AX 不包含点击次数},{6 可以在把各项业务活动中videosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
过滤器：
请使用 0 或 1 country、large、subContinent
请使用 0 或 1 video、group

美国各州的基本用户活动统计信息

该报告会提供美国特定州或哥伦比亚特区的统计信息。请注意，此报告仅支持上述针对具体国家/地区的报告中提供的部分指标。

内容
尺寸：
[无]
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentageannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
必需 province
请使用 0 或 1 video、group

基于时间

特定时间段内按国家/地区细分的用户活动

此报告提供特定时间间隔内与频道上的用户操作相关的统计信息。您可以对报告进行过滤，仅返回特定视频或国家/地区的数据。

内容
尺寸：
请仅使用 1 个 day、month
选填 creatorContentType
指标：
使用 1 项或更多 views,redViews,comments4Clicks2, {可以 6%{6AB><><b><b><相关政策},{可以把广告触发。videosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
过滤器：
请使用 0 或 1 country、large、subContinent
请使用 0 或 1 video、group

美国各州特定时间段内的用户活动

该报告会提供与美国特定州或哥伦比亚特区的用户活动相关的统计信息。请注意，此报告仅支持上述针对具体国家/地区的报告中提供的部分指标。

内容
尺寸：
请仅使用 1 个 day、month
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentageannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
必需 province
请使用 0 或 1 video、group

用户地理位置

按国家/地区细分的用户活动

此报告按国家/地区提供频道与用户活动相关的统计信息。您可以对报告进行过滤，仅返回特定视频的数据。

内容
尺寸：
必需 country
选填 creatorContentType
指标：
使用 1 项或更多 views,redViews,comment3Revenue{6annotation3,当返回。{6{6AX 不包含点击次数},{6 可以在把各项业务活动中videosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
过滤器：
请使用 0 或 1 country、subContinent
请使用 0 或 1 video、group

用户活动（按省份）

此报告提供美国各州和哥伦比亚特区的用户活动统计信息。对于此报告，您必须将 filters 参数值设为 country==US。

内容
尺寸：
必需 province
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentageannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
必需 country==美国
请使用 0 或 1 video、group

按城市细分的用户活动（<= 250 条结果）

注意：此报告要求您将 maxResults 参数设置为不超过 250 的整数值。与大多数其他报告不同，此报告还要求您为 sort 请求参数的值指定一个值。

此报告可按城市提供用户活动统计信息。

内容
尺寸：
必需 city
使用 0 或更多值 creatorContentType、country、province、subscribedStatus

注意：如果添加省/自治区/直辖市维度，则还必须使用 country==US 过滤条件。
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
排序选项： -观看次数
-estimatedMinutesWatched

播放详情

播放详情报告提供与以下观看属性相关的统计信息：

  • 观看的是直播视频还是点播视频？
  • 观看者是否订阅了该视频所属的频道？
  • 此次观看发生在哪个 YouTube 产品上？

注意：liveOrOnDemand 维度和过滤条件不能与 averageViewPercentage 指标结合使用。因此，以下每个小节都会列出两种报告。一个报告支持“liveOrOnDemand”维度（和过滤条件），而另一个报告支持 averageViewPercentage 指标。liveOrOnDemand

用户活动（按订阅状态）

此报告可针对已订阅和未订阅的观看者提供用户活动指标。您可以按时间段（天或月）对统计信息进行分组，还可以按国家/地区、大洲或subContinent对报告进行过滤。

内容
尺寸：
使用 0 或更多值 creatorContentType、subscribedStatus
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、redViews、likes、likes4annotations、annotations、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
请使用 0 或 1 country、large、subContinent
请使用 0 或 1 video、group
选填 subscribedStatus

各省份的用户活动（按订阅状态划分）

此报告提供了针对美国各州或哥伦比亚特区的已订阅和未订阅观看者的用户活动指标。与上一个报告相比，此报告支持的指标较少。

内容
尺寸：
使用 0 或更多值 creatorContentType、subscribedStatus
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentageannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
请使用 0 或 1 video、group
使用 0 或更多值 province、subscribedStatus

包含可选时间维度的播放详情

时间维度（天或月）对这些报告是可选的，因为无论如何，您都需要使用startDate和endDate请求参数来指定报告要涵盖的日期范围。此维度（如果存在）表示您希望按天、月等汇总报告中的数据。

播放详细信息以及可选的时间维度和 liveOrOnDemand 统计信息

此报告提供特定时间间隔内的播放详细统计信息。它支持 liveOrOnDemand 维度（和过滤条件）。

内容
尺寸：
使用 0 或更多值 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus、youtubeProduct
包含可选的时间维度和 averageViewPercentage 指标的播放详情

此报告提供特定时间间隔内的播放详细统计信息。它支持 averageViewPercentage 指标。

内容
尺寸：
使用 0 或更多值 creatorContentType、subscribedStatus、youtubeProduct
请使用 0 或 1 day、month
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 subscribedStatus、youtubeProduct

各个国家/地区的播放详情

按国家/地区划分的播放详细信息，其中包含 liveOrOnDemand 统计信息

该报告提供各个国家/地区的播放详情统计信息。它支持 liveOrOnDemand 维度（和过滤条件）。

内容
尺寸：
必需 country
使用 0 或更多值 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤器：
请使用 0 或 1 country、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus、youtubeProduct
采用 averageViewPercentage 指标的播放详细信息（按国家/地区）

下面的报告与前一个报告类似。它增加了对 averageViewPercentage 指标的支持，但不支持将 liveOrOnDemand 作为维度或过滤条件。

内容
尺寸：
必需 country
使用 0 或更多值 creatorContentType、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
请使用 0 或 1 country、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 subscribedStatus、youtubeProduct

各省级行政区的播放详细信息

按省级行政区划分的播放详细信息，其中包含 liveOrOnDemand 统计信息

此报告提供美国各州和哥伦比亚特区的播放详细统计信息。它支持 liveOrOnDemand 维度（和过滤条件）。

内容
尺寸：
必需 province
使用 0 或更多值 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤器：
必需 国家/地区==US
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus、youtubeProduct
按省/自治区/直辖市使用 averageViewPercentage 指标的播放详细信息

下面的报告与前一个报告类似。它增加了对 averageViewPercentage 指标的支持，但不支持将 liveOrOnDemand 作为维度或过滤条件。

内容
尺寸：
必需 province
使用 0 或更多值 creatorContentType、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
必需 国家/地区==US
请使用 0 或 1 video、group
使用 0 或更多值 subscribedStatus、youtubeProduct

播放位置

视频播放位置报告

此报告提供与视频播放的网页或应用类型相关的统计信息。

内容
尺寸：
必需 insightPlaybackLocationType
使用 0 或更多值 creatorContentType、day、liveOrOnDemand、subscribedStatus
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus

播放位置详情（不超过 25 条结果）

注意：此报告要求您将 maxResults 参数设置为不超过 25 的整数值。与大多数其他报告不同，此报告还要求您为 sort 请求参数的值指定一个值。

此报告可找出哪些嵌入式视频播放器为频道的视频带来了最多观看次数或观看时长。

内容
尺寸：
必需 insightPlaybackLocationDetail
选填 creatorContentType
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
必需 insightPlaybackLocationType==EMBEDDED
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus
排序选项： -观看次数
-estimatedMinutesWatched

流量来源

流量来源

此报告会根据观看者找到您视频内容的方式汇总观看统计信息。例如，标识源自 Google 搜索或指向相关视频的链接的观看次数。

内容
尺寸：
必需 insightTrafficSourceType
使用 0 或更多值 creatorContentType、day、liveOrOnDemand、subscribedStatus
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus

流量来源详情（<= 25 条结果）

注意：此报告要求您将 maxResults 参数设置为不超过 25 的整数值。与大多数其他报告不同，此报告还要求您为 sort 请求参数的值指定一个值。

此报告会根据为频道内容带来最多观看次数的引荐来源汇总观看统计信息。引荐来源网址按流量来源类型分类，而 insightTrafficSourceDetail 维度的定义可标识可提供相关报告的流量来源。例如，如果您将 insightTrafficSourceType 过滤条件设置为 ADVERTISING，则该报表会列出为频道内容带来最多观看次数或观看时间的广告类型。

内容
尺寸：
必需 insightTrafficSourceDetail
选填 creatorContentType
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
必需 insightTrafficSourceType（请参阅下表中的备注）
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus
排序选项： -观看次数
-estimatedMinutesWatched

注意：此报告仅适用于特定流量来源。例如，NO_LINK_EMBEDDED 流量来源没有更多详情，因此无法提供此报告。请查看 insightTrafficSourceType 定义，详细了解哪些流量来源支持此报告。

设备类型和操作系统

设备类型

此报告会根据观看者找到您视频内容的方式汇总观看统计信息。例如，它标识在移动设备或游戏机上发生的观看次数。

内容
尺寸：
必需 deviceType
使用 0 或更多值 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

操作系统

此报告会根据观看者的操作系统汇总观看统计信息。例如，它标识在 Android 设备或 PlayStation 上产生的观看次数。

内容
尺寸：
必需 operatingSystem
使用 0 或更多值 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

操作系统和设备类型

此报告根据观看者的操作系统和设备类型汇总观看统计信息。例如，它标识在 Android 平板电脑或 Windows 桌面设备上发生的查看次数。

内容
尺寸：
必需 deviceType、operatingSystem
使用 0 或更多值 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：
使用 1 项或更多 次观看、estimatedMinutesWatched
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus、youtubeProduct

观看者受众特征

此报告会根据观看者的年龄段和性别汇总观看统计信息。

内容
尺寸：
使用 1 项或更多 ageGroup、gender
使用 0 或更多值 creatorContentType、liveOrOnDemand、subscribedStatus
指标：
使用 1 项或更多 viewerPercentage
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
请使用 0 或 1 video、group
使用 0 或更多值 liveOrOnDemand、subscribedStatus
注意：对于不同的播放详细信息维度（subscribedStatus、liveOrOnDemand 或 youtubeProduct）的不同值或值组合，此报告中的 viewerPercentage 值未进行标准化处理。

例如，如果报告使用 subscribedStatus 维度，则将观看次数加到 viewerPercentageviewerPercentage（报告中所有 viewerPercentage 字段的总值为 200%。）

您可以使用过滤条件来确保报告仅包含播放详细信息维度的一个值（或值组合）的 viewerPercentage 数据。

互动度和内容分享

此报告提供的统计信息显示了频道的视频在不同社交平台上的分享频率。

内容
尺寸：
必需 sharingService
使用 0 或更多值 creatorContentType、subscribedStatus
指标：
使用 1 项或更多 股份
过滤器：
请使用 0 或 1 country、large、subContinent
请使用 0 或 1 video、group
选填 subscribedStatus

观众黏度

此报告用于衡量视频留住观众的能力。elapsedVideoTimeRatio 维度根据相应的指标值，衡量视频的已播放时长。audienceWatchRatio 和 relativeRetentionPerformance 指标提供了两种衡量指标，可以显示视频在留住受众群体方面的成效如何。第一个值是绝对值，第二个则是视频相对于其他时长相近的 YouTube 视频的表现。

注意：观众黏度报告不支持为“video”过滤条件指定以英文逗号分隔的值列表；该值必须指定一个视频 ID。

内容
尺寸：
必需 elapsedVideoTimeRatio
选填 creatorContentType
指标：
使用 1 项或更多 audienceWatchRatio、relativeRetentionPerformance
过滤器：
必需 视频
使用 0 或更多值 audienceType、subscribedStatus、youtubeProduct

热门视频

注意：这些报告要求您将 maxResults 参数设置为不超过 200 的整数值。2013 年 1 月 1 日之前的数据仅涵盖排名前 10 的视频。与大多数其他报告不同，这些报告还要求您为 sort 请求参数的值指定一个值。

具有可选地区性过滤条件的热门视频（<= 200 个结果）

此报告会列出频道的热门视频。您可以过滤报告，按国家/地区、大洲或subContinent列出热门视频。

内容
尺寸：
必需 视频
选填 creatorContentType
指标：
使用 1 项或更多 views,redViews,comment3Revenue{6annotation3,当返回。{6{6AX 不包含点击次数},{6 可以在把各项业务活动中videosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
过滤器：
请使用 0 或 1 country、large、subContinent
排序选项： -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

各州热门视频（<= 200 个结果）

此报告会列出频道在美国特定州或哥伦比亚特区的热门视频。请注意，此报告仅支持上述针对具体国家/地区的报告中提供的部分指标。

内容
尺寸：
必需 视频
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentageannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
必需 province
选填 subscribedStatus
排序选项： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

订阅或未订阅观看者最多的视频（<= 200 条结果）

此报告会列出频道中订阅或未订阅观看者的热门视频。您可以过滤报告，按国家/地区、大洲或subContinent列出热门视频。上一个报告可让您检索美国特定州的订阅者或未订阅观看者的热门视频，但此报告支持的指标比此报告少。

内容
尺寸：
必需 视频
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、likes、likes4annotations、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
过滤器：
选填 subscribedStatus
请使用 0 或 1 country、large、subContinent
排序选项： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

按 YouTube 产品划分的热门视频（<= 200 个结果）

此报告列出了频道的热门视频，并支持播放详情和地理位置过滤条件。此报告与前一种报告类似，但它支持的指标较少，并且增加了对 youtubeProduct 过滤条件的支持。

内容
尺寸：
必需 视频
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
使用 0 或更多值 subscribedStatus、youtubeProduct
排序选项： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

具有播放详情过滤条件的热门视频（不超过 200 条结果）

此报告会列出频道的热门视频，并按任意或所有播放详细信息维度（liveOrOnDemand、subscribedStatus 和 youtubeProduct）进行过滤。与之前的报告不同，此报告支持 liveOrOnDemand 过滤条件，但不支持 averageViewPercentage 指标。

内容
尺寸：
必需 视频
选填 creatorContentType
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤器：
请使用 0 或 1 country、province、大陆、subContinent
使用 0 或更多值 liveOrOnDemand、subscribedStatus、youtubeProduct
排序选项： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

播放列表报告

播放列表报告包含与频道所有者播放列表中的视频相关的用户活动相关的指标。这些报告有两个版本，对于每个可用的报告，以下部分包含每个版本的说明：

  • 各部分中的建议标签页介绍了用于检索相应报告的首选 API 请求格式。推荐的报告支持一组经过扩展的指标，其中包括汇总视频指标和播放列表内指标。此请求格式不使用 isCurated 维度。
  • 各部分中的使用 isCurated 标签页介绍了一种旧的 API 请求格式，该格式必须使用 isCurated 维度。这些报告仅支持播放列表内指标。请注意，isCurated 维度已针对所有报告弃用。下面的警告说明介绍了弃用时间表。

以下警告说明更详细地说明了这两个报告版本之间的变化。

汇总的视频指标

这些指标会提供用户活动和展示次数指标，这些指标会针对播放列表中的所有视频（同时也归拥有该播放列表的频道）提供汇总。汇总时不会计算其他频道所拥有的视频的指标。因此，如果某个频道创建的播放列表只包含其他频道所拥有的视频，那么这些播放列表的报告将不会提供这些指标的值。

如需查看 YouTube 支持的汇总视频指标列表，请参阅支持的播放列表指标部分。

播放列表内指标

这些指标反映了播放列表页面中的用户活动和互动度。这些指标包括播放列表中所有视频的观看次数（无论它们归哪个频道所有），但仅统计在播放列表环境中发生的观看次数。

支持的播放列表指标

基本统计数据

此报告会提供用户与频道播放列表中的视频互动情况的相关统计信息。您可以过滤该报告，使其仅返回特定播放列表的数据。

使用 isCurated
内容
尺寸：
[无]
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
过滤器：
必需 isCurated==1
请使用 0 或 1 playlist、group
请使用 0 或 1 country、province、大陆、subContinent
使用 0 或更多值 subscribedStatus、youtubeProduct

基于时间

此报告会提供用户与频道播放列表中的视频互动情况的相关统计信息。您可以过滤该报告，使其仅返回特定播放列表的数据。

用户地理位置

播放列表活动（按国家/地区）

该报告会提供特定国家/地区用户与频道播放列表中的视频的互动情况的相关统计信息。

播放列表活动（按省份）

此报告可提供美国各州和哥伦比亚特区的播放列表活动统计信息。 对于此报告，您必须过滤结果以仅返回美国的数据。

播放位置

此报告提供与播放列表中视频播放次数的网页或应用类型相关的统计信息。

播放位置详情（不超过 25 条结果）

注意：此报告要求您将 maxResults 参数设置为不超过 25 的整数值。与大多数其他报告不同，此报告还要求您为 sort 请求参数的值指定一个值。

此报告会找出为频道播放列表中的视频带来最多观看次数或观看时长的嵌入式视频播放器。

流量来源

此报告会根据观看者找到您播放列表内容的方式汇总观看统计信息。 例如，它标识源自 Google 搜索的观看次数。

流量来源详情（<= 25 条结果）

注意：此报告要求您将 maxResults 参数设置为不超过 25 的整数值。与大多数其他报告不同，此报告还要求您为 sort 请求参数的值指定一个值。

此报告会根据为频道播放列表中的视频带来最多观看次数的引荐来源汇总观看统计信息。引荐来源网址按流量来源类型分类，insightTrafficSourceDetail 维度的定义可标识可提供报告的流量来源。

例如，如果您将 insightTrafficSourceType 过滤条件设置为 ADVERTISING，则报告会列出为频道的播放列表带来最多观看次数或观看时间的广告类型。

推荐
内容
尺寸：
必需 insightTrafficSourceDetail
指标：
使用 1 项或更多 views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStartviews
过滤器：
必需 insightTrafficSourceType==ADVERTISING（或其他支持的值）
请仅使用 1 个 playlist、group
排序选项： -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

注意：此报告仅适用于特定流量来源。例如，NO_LINK_EMBEDDED 流量来源没有更多详情，因此无法提供此报告。请查看 insightTrafficSourceType 定义，详细了解哪些流量来源支持此报告。

设备类型和操作系统

设备类型

此报告会根据观看者找到您播放列表中视频的方式汇总观看统计信息。例如，它标识在移动设备或游戏机上发生的查看次数。

操作系统

此报告会根据观看者的操作系统汇总观看统计信息。例如，它标识在 Android 设备或 PlayStation 上产生的观看次数。

操作系统和设备类型

此报告根据观看者的操作系统和设备类型汇总观看统计信息。 例如，它可识别 Android 平板电脑或 Windows 桌面设备上产生的观看次数。

观看者受众特征

使用 isCurated
内容
尺寸：
使用 1 项或更多 ageGroup、gender
使用 0 或更多值 subscribedStatus
指标：
必需 viewerPercentage
过滤器：
必需 isCurated==1
请使用 0 或 1 playlist、group
请使用 0 或 1 country、province、大陆、subContinent
选填 subscribedStatus
注意：此报告中的 viewerPercentage 值未按照 subscribedStatus 播放详细信息维度的不同值进行标准化处理。

例如，如果报告使用 subscribedStatus 维度，则会返回 viewerPercentage 数据（订阅观看次数加起来等于 100%）， viewerPercentage的数据加总后达到 100%。（报告中所有 viewerPercentage 字段的总值为 200%。）

您可以使用过滤条件来确保报告仅包含 subscribedStatus 维度的一个值的 viewerPercentage 数据。

表现最好的播放列表

注意：这些报告要求您将 maxResults 参数设置为不超过 200 的整数值。2013 年 1 月 1 日之前的数据仅涵盖前 10 个播放列表。与大多数其他报告不同，这些报告还要求您为 sort 请求参数的值指定一个值。

此报告会根据指定的过滤和排序条件，列出频道表现最好的播放列表。

使用 isCurated
内容
尺寸：
必需 播放列表
指标：
使用 1 项或更多 views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist
过滤器：
必需 isCurated==1
请使用 0 或 1 country、province、大陆、subContinent
使用 0 或更多值 playlist、subscribedStatus、youtubeProduct
排序选项： -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

广告效果报告

注意：广告效果报告需要授权令牌，用来授予对 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 范围的访问权限。

广告效果报告可为视频播放期间投放的广告提供基于展示次数的指标。这些指标统计了每次广告展示，并且每次视频播放可产生多次展示。

基于展示次数的广告效果指标包括：

此外，一些视频报告还支持下列基于播放的广告效果指标。不过，广告效果报告中不包含这些指标。

广告效果（按广告类型）

内容
尺寸：
必需 adType
选填 天
指标：
使用 1 项或更多 grossRevenue、adImpressions、cpm
过滤器：
请使用 0 或 1 video、group
请使用 0 或 1 country、large、subContinent