YouTube Analytics API: Content Owner Reports

注意： Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

本页列出了内容所有者可通过 YouTube Analytics API 检索的报告。内容所有者报告包含与指定 YouTube 内容所有者相关联的频道的指标。指标是对用户活动、广告效果或估计收入的单独衡量结果。

• 视频报告包含内容所有者频道上视频的用户活动、广告效果和估计收入指标。

• 播放列表报告提供与播放列表中的视频观看次数相关的统计信息。播放列表报告使用的维度和过滤条件与视频报告基本相同。

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

检索报告

如需检索内容所有者报告，请调用 API 的 reports.query 方法，并将 API 请求中的 ids 参数值设置为 contentOwner==OWNER_NAME，其中 OWNER_NAME 指定内容所有者的 ID。如果您不确定该值，请咨询您的合作伙伴经理。

授权

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

YouTube 数据分析 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 范围的访问权限。

过滤条件

所有用于检索内容所有者报告的 API 请求都必须使用 video 维度、channel 维度或 claimedStatus 和 uploaderType 维度的受支持组合来过滤数据。（受支持的组合列在 uploaderType 维度的定义中。）

介绍支持的报告的表格会指明可用于任何给定报告的过滤条件。在说明中，圆括号内的过滤条件是可选的。例如，如果报告将 video(,country) 列为过滤选项，则可以过滤报告，使其仅包含特定视频的数据，或者仅包含特定国家/地区中特定视频的数据。

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

如需详细了解如何按特定值或一组值过滤 API 结果，请参阅 filters 参数定义。

了解报告表格

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

目录
尺寸：	使用 0 个或更多 creatorContentType、subscribedStatus、youtubeProduct 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 0 或 1 country、province、continent、subContinent 使用 0 或 1 视频、群组 使用 0 个或更多 subscribedStatus、youtubeProduct

该表包含两行维度、一行指标和三行过滤器。对于维度和过滤条件，只要组合符合表中的使用规则，API 请求中就可以包含每一行的值。因此，举例来说，此报告的有效 dimensions 参数值包括：

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

不过，参数值 day,month 无效，因为它使用了两个基于时间的维度，而请求必须使用 0 或 1。

报告表格术语

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

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

视频报告

基本统计数据

基本统计信息（包括订阅人数）

此报告提供与内容所有者的所有频道上的用户操作相关的统计信息。您可以过滤报告，以仅返回特定视频或国家/地区的数据。它还可用于仅检索已声明版权的内容的统计信息，包括内容所有者、第三方或两者上传的已声明版权的内容。

目录
尺寸：	[无]
指标：	使用 1 个或更多 engagedViews*、playbackBasedCpm
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、continent、subContinent

美国各州的基本统计数据

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

目录
尺寸：	[无]
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 province

基于时间

时间段的活动

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

目录
尺寸：	使用 1 天、月 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews*、monetizedPlaybacks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、continent、subContinent

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

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

目录
尺寸：	使用 1 天、月 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 province

用户地理位置

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

此报告按国家/地区提供与内容所有者的所有频道上的用户活动相关的统计信息。您可以过滤报告，使其仅返回特定视频或频道的数据。

目录
尺寸：	必需 country 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews*、playbackBasedCpm
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 continent、subContinent

用户活动（按省份）

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

目录
尺寸：	必需 province 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 country==US

按城市统计的用户活动（最多 250 个结果）

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

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

目录
尺寸：	必需 city 使用 0 个或更多 creatorContentType、country、province、subscribedStatus 注意：如果您包含 province 维度，还必须使用 country==US 过滤条件。 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent
排序选项：	-engagedViews -views -estimatedMinutesWatched

播放详情

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

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

从技术上讲，这些报告支持的播放详情维度都是可选的。如果您未在请求中添加播放详情维度，返回的报告实际上会类似于基本统计信息、基于时间的统计信息或用户地理位置报告。

注意：liveOrOnDemand 维度和过滤条件不能与 averageViewPercentage 指标搭配使用。因此，以下各子部分分别列出了两份报告。一个报告支持 liveOrOnDemand 维度（和过滤条件），而另一个报告支持 averageViewPercentage 指标。

按订阅状态划分的用户活动

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

目录
尺寸：	使用 0 个或更多 creatorContentType、subscribedStatus 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、continent、subContinent 可选 subscribedStatus

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

此报告提供美国各州或哥伦比亚特区订阅观看者和未订阅观看者的用户活动指标。此报告支持的指标比之前的报告少。

目录
尺寸：	使用 0 个或更多 creatorContentType、subscribedStatus 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 province 可选 subscribedStatus

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

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

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

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

目录
尺寸：	使用 0 个或更多 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus、youtubeProduct

包含可选时间维度和 averageViewPercentage 指标的播放详情

此报告提供特定时间间隔内的播放详细统计信息。

目录
尺寸：	使用 0 个或更多 creatorContentType、subscribedStatus、youtubeProduct 使用 0 或 1 天、月
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 subscribedStatus、youtubeProduct

按国家/地区划分的播放详情

按国家/地区显示包含 liveOrOnDemand 统计信息的播放详细信息

此报告按国家/地区提供播放详细统计信息。它支持 liveOrOnDemand 维度（和过滤条件）。

目录
尺寸：	可选 country 使用 0 个或更多 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus、youtubeProduct

按国家/地区划分的播放详情，包含 averageViewPercentage 指标

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

目录
尺寸：	可选 country 使用 0 个或更多 creatorContentType、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 continent、subContinent 使用 0 个或更多 subscribedStatus、youtubeProduct

各省的播放详情

按省份划分的播放详细信息，包含 liveOrOnDemand 统计信息

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

目录
尺寸：	可选 province 使用 0 个或更多 creatorContentType、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 国家/地区==US 使用 0 个或更多 liveOrOnDemand、subscribedStatus、youtubeProduct

按省份划分的播放详细信息，包含 averageViewPercentage 指标

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

目录
尺寸：	可选 province 使用 0 个或更多 creatorContentType、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 国家/地区==US 使用 0 个或更多 subscribedStatus、youtubeProduct

播放位置

视频播放位置报告

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

目录
尺寸：	必需 insightPlaybackLocationType 使用 0 个或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus

播放位置详情 （最多 25 个结果）

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

此报告会显示哪些嵌入式视频播放器为内容所有者的内容带来了最多的观看次数或观看时长。检索此报告时，您必须将 insightPlaybackLocationType 过滤条件设置为 EMBEDDED。

目录
尺寸：	必需 insightPlaybackLocationDetail 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 insightPlaybackLocationType==EMBEDDED 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus
排序选项：	-engagedViews -views -estimatedMinutesWatched

流量来源

流量来源

此报告会根据观看者观看您视频内容的方式汇总观看统计信息。例如，它可以确定来自 Google 搜索或相关视频链接的观看次数。

注意：如果查询的视频数量与日期范围内的天数的乘积超过 50,000，此报告会返回错误。例如，检索 500 个视频 ID 的数据的查询最多可以请求 100 天的数据。如需减少请求返回的行数，请将查询拆分为多个查询，每个查询指定较少的视频或设置较短的日期范围。

目录
尺寸：	必需 insightTrafficSourceType 使用 0 个或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus

流量来源详细信息（最多 25 个结果）

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

此报告会根据为内容所有者的内容带来最多观看次数的引荐来源网址汇总观看情况统计信息。引荐来源网址按流量来源类型进行分类，insightTrafficSourceDetail 维度的定义指明了哪些流量来源可用于生成报告。例如，如果您将 insightTrafficSourceType 过滤条件设置为 ADVERTISING，报告将列出为内容所有者的内容带来最多观看次数或观看时长的广告类型。

目录
尺寸：	必需 insightTrafficSourceDetail 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 必需 insightTrafficSourceType（请参阅下表中的备注） 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus
排序选项：	-engagedViews -views -estimatedMinutesWatched

注意：此报告仅支持特定流量来源。VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES 和 NO_LINK_EMBEDDED 流量来源是不受支持的流量来源。

设备类型和操作系统

设备类型

此报告会根据观看者观看您内容时所用设备的类型汇总观看统计信息。例如，它可以识别平板电脑或游戏机上的观看次数。

目录
尺寸：	必需 deviceType 使用 0 个或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

操作系统

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

目录
尺寸：	必需 operatingSystem 使用 0 个或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 deviceType、liveOrOnDemand、subscribedStatus、youtubeProduct

操作系统和设备类型

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

目录
尺寸：	必需 operatingSystem、deviceType 使用 0 个或更多 creatorContentType、day、liveOrOnDemand、subscribedStatus、youtubeProduct
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus、youtubeProduct

观看者受众特征

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

目录
尺寸：	使用 1 个或更多 ageGroup、gender 使用 0 个或更多 creatorContentType、liveOrOnDemand、subscribedStatus
指标：	使用 1 个或更多 viewerPercentage
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus

互动和内容分享

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

目录
尺寸：	必需 sharingService 可选 creatorContentType、subscribedStatus
指标：	使用 1 个或更多 分享
过滤条件：	使用 1 视频、频道、群组，或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、continent、subContinent 可选 subscribedStatus

观众黏度

此报告用于衡量视频在吸引观众方面的表现。elapsedVideoTimeRatio 维度用于衡量相应指标值所对应的视频播放时长。audienceWatchRatio 和 relativeRetentionPerformance 指标提供了两种衡量标准，可用于衡量视频对观众的吸引力。第一个是绝对值，而第二个则显示了视频相对于 YouTube 上时长相近的其他视频的表现。

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

目录
尺寸：	必需 elapsedVideoTimeRatio 可选 creatorContentType
指标：	使用 1 个或更多 audienceWatchRatio、relativeRetentionPerformance
过滤条件：	必需 视频 使用 0 个或更多 audienceType、subscribedStatus、youtubeProduct

热门视频

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

按国家/地区、洲或次大陆列出的热门视频总榜（最多 200 个结果）

此报告会根据指定的过滤和排序条件列出内容所有者的热门视频。

目录
尺寸：	必需 视频 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews*、playbackBasedCpm
过滤条件：	使用 1 频道或受支持的 uploaderType 和 claimedStatus 组合 使用 0 或 1 country、continent、subContinent
排序选项：	-engagedViews -views -redViews -estimatedRevenue -estimatedRedPartnerRevenue -estimatedMinutesWatched -estimatedRedMinutesWatched -subscribersGained -subscribersLost

美国各州的热门视频（最多 200 个结果）

此报告列出了内容所有者在美国特定州或哥伦比亚特区内的热门视频。请注意，此报告仅支持上述特定国家/地区报告中的部分指标。

目录
尺寸：	必需 视频 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 频道或受支持的 uploaderType 和 claimedStatus 组合 必需 province
排序选项：	-engagedViews -views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

面向订阅者或非订阅者的热门视频（最多 200 个结果）

此报告会列出订阅者或非订阅者观看的热门视频。您可以过滤报告，按国家/地区、洲或subContinent列出热门视频。之前的报告可让您检索美国特定州内订阅者或非订阅者观看次数最多的视频，但它支持的指标比此报告少。

目录
尺寸：	必需 视频 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、likes、dislikes、videosAddedToPlaylists、videosRemovedFromPlaylists、shares、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage、annotationClickThroughRate、annotationCloseRate、annotationImpressions、annotationClickableImpressions、annotationClosableImpressions、annotationClicks、annotationCloses、cardClickRate、cardTeaserClickRate、cardImpressions、cardTeaserImpressions、cardClicks、cardTeaserClicks
过滤条件：	使用 1 频道或受支持的 uploaderType 和 claimedStatus 组合 可选 subscribedStatus 使用 0 或 1 country、continent、subContinent
排序选项：	-engagedViews -views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

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

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

目录
尺寸：	必需 视频 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration、averageViewPercentage
过滤条件：	使用 1 频道或受支持的 uploaderType 和 claimedStatus 组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 subscribedStatus、youtubeProduct
排序选项：	-engagedViews -views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

包含播放详情过滤条件的热门视频（最多 200 个结果）

此报告列出了内容所有者的热门视频，并按一个或多个播放详细信息维度进行过滤：liveOrOnDemand、subscribedStatus 和 youtubeProduct。该报告还支持按区域进行过滤。

目录
尺寸：	必需 视频 可选 creatorContentType
指标：	使用 1 个或更多 engagedViews、views、redViews、estimatedMinutesWatched、estimatedRedMinutesWatched、averageViewDuration
过滤条件：	使用 1 频道或受支持的 uploaderType 和 claimedStatus 组合 使用 0 或 1 country、province、continent、subContinent 使用 0 个或更多 liveOrOnDemand、subscribedStatus、youtubeProduct
排序选项：	-engagedViews -views -redViews -estimatedMinutesWatched -estimatedRedMinutesWatched

播放列表报告

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

汇总视频指标

这些指标提供用户活动和展示指标，这些指标是针对播放列表中的所有视频（这些视频也归播放列表所属的频道所有）汇总的。聚合中不会计算其他频道所拥有的视频的指标。因此，如果某个频道创建的播放列表仅包含其他频道拥有的视频，则这些播放列表的报告不会提供这些指标的值。

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

播放列表内指标

这些指标反映了用户在播放列表页面上的活动和互动情况。这些指标会纳入播放列表中所有视频的观看次数，无论这些视频归哪个频道所有，但只会统计在播放列表环境中发生的观看次数。

支持的播放列表指标

目录
汇总视频指标	engagedViews、views、estimatedMinutesWatched、averageViewDuration
播放列表内指标	playlistViews、playlistEstimatedMinutesWatched、playlistAverageViewDuration、playlistSaves、playlistStarts、viewsPerPlaylistStart、averageTimeInPlaylist

基本统计数据

此报告提供与用户在内容所有者频道上与播放列表中的视频互动相关的统计信息。报告不包含任何必需的维度。

目录
尺寸：	[无]
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

基于时间

此报告提供与内容所有者频道在特定时间间隔内播放列表中的视频的用户互动相关的统计信息。您可以过滤报告，使其仅返回特定播放列表或频道的数据。

目录
尺寸：	使用 1 天、月
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

用户地理位置

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

此报告按国家/地区提供播放列表统计信息。

目录
尺寸：	必需 country
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 使用 0 或 1 continent、subContinent 可选 channel

各省份的播放列表活动

此报告提供美国各州和哥伦比亚特区的播放列表活动统计信息。对于此报告，您需要在 filters 参数值中添加 country==US。

目录
尺寸：	必需 province
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration
过滤条件：	必需 国家/地区==US 使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

播放位置

此报告提供与播放列表播放发生的网页或应用类型相关的统计信息。

目录
尺寸：	必需 insightPlaybackLocationType
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

播放位置详情 （最多 25 个结果）

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

此报告可确定为内容所有者的播放列表带来最多观看次数或观看时长的嵌入式视频播放器。

目录
尺寸：	必需 insightPlaybackLocationDetail
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	必需 insightPlaybackLocationType==EMBEDDED 使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel
排序选项：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

流量来源

此报告会根据观看者访问播放列表内容的方式汇总观看统计信息。例如，它可以确定源自 Google 搜索或频道页面的观看次数。

目录
尺寸：	必需 insightTrafficSourceType
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

流量来源详细信息（最多 25 个结果）

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

此报告会根据为内容所有者的播放列表带来最多观看次数的引荐来源网址汇总观看情况统计信息。引荐来源网址按流量来源类型进行分类，insightTrafficSourceDetail 维度的定义指明了哪些流量来源可用于生成报告。例如，如果您将 insightTrafficSourceType 过滤条件设置为 ADVERTISING，报告将列出为内容所有者的播放列表带来最多观看次数或观看时长的广告类型。

目录
尺寸：	必需 insightTrafficSourceDetail
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	必需 insightTrafficSourceType 使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel
排序选项：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

注意：此报告仅支持特定流量来源。VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES 和 NO_LINK_EMBEDDED 流量来源是不受支持的流量来源。

设备类型和操作系统

播放列表的设备类型

此报告会根据观看者观看播放列表内容时所用的设备类型汇总观看统计信息。例如，它可以识别在移动设备或游戏机上发生的观看次数。

目录
尺寸：	必需 deviceType
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

播放列表的操作系统

此报告会根据观看者的操作系统汇总观看统计信息。例如，它可以确定在 Android 设备或 PlayStation 上发生的播放列表观看次数。

目录
尺寸：	必需 operatingSystem
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

播放列表的操作系统和设备类型

此报告会根据观看者的操作系统和设备类型汇总观看统计信息。例如，它可以确定在 Android 平板电脑或 Windows 桌面设备上发生的播放列表观看次数。

目录
尺寸：	必需 deviceType、operatingSystem
指标：	使用 1 个或更多 engagedViews、views、estimatedMinutesWatched、averageViewDuration、averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistStarts、playlistViews、viewsPerPlaylistStart
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

观看者受众特征

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

目录
尺寸：	使用 1 个或更多 ageGroup、gender
指标：	必需 viewerPercentage
过滤条件：	使用 0 或 1* 播放列表、群组 注意：如果报告中请求了任何观看次数、estimatedMinutesWatched或averageViewDuration指标，则必须指定其中一个过滤条件。 可选 channel

表现最好的播放列表

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

此报告会根据指定的过滤和排序条件，列出内容所有者的热门播放列表。

目录
尺寸：	必需 播放列表
指标：	使用 1 个或更多 averageTimeInPlaylist、playlistAverageViewDuration、playlistEstimatedMinutesWatched、playlistSaves、playlistStarts、playlistViews、viewsPerPlaylistStart
排序选项：	-playlistViews -playlistEstimatedMinutesWatched -playlistStarts

广告效果报告

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

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

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

• grossRevenue
• adImpressions
• cpm

此外，部分视频报告支持以下基于播放的广告效果指标。不过，这些指标不会包含在广告效果报告中。

• playbackBasedCpm
• monetizedPlaybacks

按广告类型细分的广告效果

目录
尺寸：	必需 adType 可选 day
指标：	使用 1 个或更多 grossRevenue、adImpressions、cpm
过滤条件：	使用 1 video、group 或 uploaderType 和 claimedStatus 的受支持组合 使用 0 或 1 country、continent、subContinent