示例 API 请求

视频报告

频道视频的每日观看时长指标

此查询会检索频道视频的每日观看次数、观看时长指标和新增订阅人数。报告会针对所请求日期范围内的每一天返回一行数据。行按时间顺序排序。

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

频道视频的每日注释指标

此请求会检索频道内容的每日观看次数、注释点击率、注释关闭率和注释展示次数。结果按时间顺序排序。

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

播放列表报告

频道的每日播放列表观看次数

此请求会检索经过身份验证的用户频道的每日观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）、播放列表开始播放的次数、估计的观看时长，以及每次播放列表开始播放时的观看次数。结果按时间顺序排序。

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

视频报告

频道视频在特定国家/地区的观看时长指标

此查询会检索频道在特定国家/地区的观看次数、观看时长指标和订阅数据。该报告会针对用户观看频道视频的每个国家/地区返回一行数据。各行按观看时长（分钟数）降序排序。

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

频道视频在特定国家/地区的注释指标

此请求会检索频道视频在特定国家/地区的观看次数、注释点击率、注释关闭率和注释展示次数。结果按注释点击率降序排列，这意味着注释点击率最高的国家/地区将列在第一位。

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

美国各州和华盛顿特区的省级指标

此请求会检索各省级行政区细分的频道视频观看次数、估计观看时长和平均观看时长。数据涵盖美国各州和华盛顿特区。结果按各州的 ISO 3166-2 代码字母顺序排序。

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

排名前 10 - 特定国家/地区观看次数最多的视频

此查询检索频道在指定国家/地区观看次数最多的 10 个视频（根据指定日期范围内的观看次数）。结果按查看次数降序排序。

注意：此报告要求您为 sort 请求参数的值指定一个值，并将 maxResults 参数设置为不超过 10 的整数值。

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

美国前 10 大城市（按总观看次数）

此查询检索指定日期范围内频道内容观看次数最多的 10 个美国城市的列表。可以通过为该过滤器选择另一个有效值，将查询修改为请求另一国家/地区的数据。同样，您也可以使用 subContinent 过滤器及其其中一个有效值修改查询，以检索次大陆（例如西欧或东南亚）的数据。还支持其他过滤条件。结果按查看次数降序排序。

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

美国各类型内容总观看次数排名前 10 的城市

此查询会针对每个支持的 creatorContentType，检索指定日期范围内频道内容观看次数最多的 10 个美国城市的列表。结果按查看次数降序排序。

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

美国前 10 大城市（按总观看时长）

此查询会检索指定日期范围内最热门的 10 天（美国任意城市）的频道内容每日总观看时长最长的前 10 天的列表。查询结果会标识总观看时长、观看时长的发生日期以及内容估计被观看的城市。结果按总观看时长降序排列。

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 大 - 欧洲观看次数最多的视频

此查询检索该频道在欧洲观看次数最多的 10 个视频（根据指定日期范围内的观看次数计算得出）。可以通过为该过滤条件选择其他有效值，将查询修改为请求另一个大洲的数据。同样，您也可以使用 subContinent 过滤器及其其中一个有效值修改查询，以检索次大陆（例如西欧或东南亚）的数据。结果按查看次数降序排序。

注意：此报告要求您为 sort 请求参数的值指定一个值，并将 maxResults 参数设置为不超过 10 的整数值。

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

播放列表报告

频道播放列表在特定国家/地区的观看时长指标

此查询会检索频道在特定国家/地区的观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）和观看时长指标。针对观看了频道播放列表的每个国家/地区，该报告会返回一行数据。各行按观看时长（分钟数）降序排序。

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

十大 - 美国观看次数最多的播放列表

此查询检索美国观看者在指定日期范围内开始观看最频繁的 10 个播放列表。结果按播放列表开始次数降序排序。

注意：由于此报告使用了“playlist”维度，因此您必须为 sort 请求参数的值指定一个值，并将 maxResults 参数设置为不超过 10 的整数值。

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

视频报告

不同播放位置的观看次数和观看时长

此查询会检索特定频道的视频的观看次数和估算观看时长。结果根据视频播放所在的网页或应用类型进行汇总，并按观看次数降序排列结果。

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

不同播放位置的每日观看次数和观看时长

此查询会检索特定频道的视频在美国的每日观看次数和估算观看时长。系统会按天对发生视频播放的每种网页或应用类型的结果进行分组。结果按时间顺序排序。

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

排名前 10 - 为嵌入式视频带来最多观看次数的第三方网站

此查询会检索特定视频或一组视频的观看次数和估算观看时长。结果会按嵌入相应视频的第三方网站进行分组。结果按观看次数降序排列。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为所上传视频的一个或多个视频 ID 的逗号分隔列表。

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

播放列表报告

来自不同播放位置的播放列表观看次数和观看时长

此查询会检索特定频道的播放列表的观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）、估算观看时长和播放列表开始次数。结果按播放视频的网页或应用类型进行汇总，并按播放列表开始次数降序排序。

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

不同播放位置的每日播放列表观看次数和观看时长

此查询会检索特定频道的播放列表的每日播放列表开始观看次数、观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）以及美国的估算观看时长。对于发生了播放列表浏览的每种网页或应用类型，结果会按天分组。结果按时间顺序排序。

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

视频报告

“赞”和“踩”的数量（按内容类型）

此查询会检索频道上每种类型内容的“赞”和“踩”的数量。

dimensions=creatorContentType
metrics=likes,dislikes

视频报告

一个国家/地区中不同流量来源的观看次数和观看时长

此请求会检索频道视频在指定国家/地区的观看次数和估算观看时长。这些指标按流量来源进行汇总，流量来源说明了用户访问视频的方式。

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

不同流量来源带来的每日观看次数和观看时长

此请求会检索频道视频的每日观看次数和每日估算观看时长。系统会按流量来源每天汇总这些指标，并按时间顺序排序。

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

前 10 - 为视频带来最多流量的 YouTube 搜索字词

此查询会检索从 YouTube 搜索结果中为一个或多个特定视频带来最多观看次数的 10 个搜索字词。结果按查看次数降序排序。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为最多包含 500 个视频 ID 的逗号分隔列表。

例如，您可以针对单个视频运行查询或替换 VIDEO_ID，以确定为该视频带来最多流量的搜索字词。您还可以列出特定播放列表中的所有视频，以便确定哪些搜索字词为该播放列表中的任何视频带来了最多的流量。

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

前 10 - 为视频带来最多流量的外部网站

此查询会检索为特定视频或某组视频带来最多观看次数的 10 个外部网站。结果按预计观看时长降序排列。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为一个逗号分隔列表，其中最多包含 500 个您已上传的视频 ID。

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

播放列表报告

一个国家/地区中不同流量来源带来的播放列表观看次数和观看时长

此请求会检索指定国家/地区的观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）、播放列表开始播放次数和播放列表观看次数的估算观看时长。这些指标按流量来源进行汇总，流量来源说明了用户访问播放列表的方式。

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

不同流量来源带来的每日播放列表观看次数和观看时长

此请求会检索频道的每日播放列表观看次数（播放列表内指标）、播放列表开始次数和估算观看时长。它还会检索总观看次数（汇总视频指标）。 系统会按流量来源每天汇总这些指标，并按时间顺序排序。

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

视频报告

Android 操作系统的每日设备类型指标

此查询会检索 Android 设备上特定频道视频的每日观看次数和估算观看时长。系统会按天分组显示有视频播放的每类设备的结果。结果按时间顺序排序。

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

移动设备的每日操作系统指标

此查询会检索特定频道的视频的每日观看次数和估算的观看时长。视频播放时按天对结果进行分组。结果按时间顺序排序。

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

每日操作系统和设备类型指标

此查询会检索频道的每日观看次数和估算观看时长。统计信息按操作系统和设备类型分组。结果按时间顺序排序。

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

播放列表报告

Android 操作系统上播放列表观看次数的每日设备类型指标

此查询会检索 Android 设备上特定频道的播放列表的每日观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）和估算观看时长。针对播放列表观看次数的每类设备，结果按天分组。结果按时间顺序排序。

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

移动设备上播放列表观看次数的每日操作系统指标

此查询会检索特定频道的播放列表的每日观看次数（汇总视频指标）、播放列表观看次数（播放列表内指标）以及在移动设备上的估算观看时长。对于播放列表观看次数所在的每个操作系统，结果按天分组。结果按时间顺序排序。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

视频报告

加利福尼亚州的观看者受众特征（年龄段和性别）

此报告会检索加利福尼亚州观看频道视频的观看者的年龄段和性别统计信息。结果先按性别排序，然后按年龄段排序。您可以修改此查询，通过调整 filters 参数值，检索全球所有观看者或某个国家/地区、大洲、次大陆或其他美国州内的所有观看者的相同统计信息。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

播放列表报告

加利福尼亚州的播放列表观看者受众特征（年龄段和性别）

此报告会检索加利福尼亚州观看频道播放列表的观看者的年龄段和性别统计信息。结果先按性别排序，然后按年龄段排序。通过调整 filters 参数值，可以修改此查询，以检索全球所有观看者或某个国家/地区、大洲、次大陆或其他美国州内的所有观看者的相同统计信息。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

分享指标（按分享视频时所用服务汇总）

此请求会检索用户使用 Share 按钮分享某个频道的视频的次数。结果按分享服务（Google+、Twitter 等）汇总，并按分享次数降序排序。

dimensions=sharingService
metrics=shares
sort=-shares

视频的观众黏度指标

此报告用于衡量视频留住观众的能力。一次只能为一个视频检索报告。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为您上传的某个视频的视频 ID。请注意，观众黏度报告不支持为“video”过滤条件指定多个值。

在此示例中，报告使用 audienceType 过滤器限制响应，使其仅包含自然观看次数的数据，自然观看次数是直接用户操作（例如搜索视频或点击推荐视频）的结果。因此，此报告不包含 TrueView 插播广告或 TrueView 展示广告的观看次数数据。您可以移除过滤条件，以检索视频的观众黏度数据（涵盖所有受众群体类型）。

请注意，audienceType过滤条件的数据自 2013 年 9 月 25 日起已提供。如果查询使用过滤条件来尝试检索较早日期的数据，该 API 不会返回相关数据。不使用该过滤器的查询会应用于 2008 年 7 月 1 日之后的任何日期。

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

频道收入和广告效果指标

此请求会检索频道的收入和广告效果指标。该报告会返回一行数据，其中包含指定日期范围内每个请求的指标的总计值。

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

每日收入和广告效果指标

此请求会检索频道的每日收入和广告效果指标。

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

特定国家/地区的收入和广告效果指标

此请求会检索频道在特定国家/地区的收入和广告效果指标。结果按收入金额降序排列，也就是说，列出的第一个国家/地区将是合作伙伴净收入最高的国家/地区。

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

十大热门视频 - 收益最高的视频

此请求会检索频道中收入最高的 10 个视频的收入和广告效果指标。结果按收入金额降序排列，这意味着第一个视频将是估算收入最高的视频。

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

不同广告类型的广告效果指标

该请求会检索内容所有者已声明版权的内容的广告效果指标。结果按广告类型分组，便于您比较不同广告类型的收入和每千次展示费用值。

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

视频报告

自行上传内容的每日观看时长指标

此查询会检索每日观看时长指标，以及内容所有者上传的视频的观看次数、创收播放次数和展示次数。报告会针对所请求日期范围内的每一天返回一行数据，并按时间顺序排列各行。

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

已声明版权的内容的注解指标

该请求会检索内容所有者已声明版权的内容的每日观看次数、注释点击率、注释关闭率和注释展示次数。结果按时间顺序排序。

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

播放列表报告

内容所有者的播放列表每日观看次数

此请求会检索用户与内容所有者播放列表中的视频进行的每日互动指标。在报告中检索到的指标为 playlistViews、playlistStarts、playlistEstimatedMinutesWatched 和 viewsPerPlaylistStart。所有这些指标都是播放列表内指标。 由于请求的所有指标都是播放列表内指标，因此该请求不需要还包含播放列表或群组过滤条件。

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

视频报告

在特定国家/地区自行上传内容的观看时长指标

此查询会检索每个国家/地区的观看次数、观看时长指标和估算广告收入。这些指标针对的是内容所有者上传的视频。该报告会针对视频观看的每个国家/地区返回一行数据，并按观看时长按照降序排列各行。

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

针对自行上传内容的具体国家/地区注释指标

该请求会检索内容所有者所上传视频在特定国家/地区的观看次数、注释点击率、注释关闭率和注释展示次数。结果按注释点击率降序排列，这意味着注释点击率最高的国家/地区将列在第一位。

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

美国各州和华盛顿特区的省级指标

此请求针对内容所有者已声明版权的视频，检索各省级行政区细分的观看次数、估计观看时长和平均观看时长。数据涵盖美国各州和华盛顿特区。结果按各州的 ISO 3166-2 代码字母顺序排序。

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

美国前 10 大城市（按总观看次数）

此查询检索指定的日期范围内，在内容所有者的已声明视频中获得最多观看次数的 10 个美国城市的列表。可以通过为该过滤器选择另一个有效值，将查询修改为请求另一国家/地区的数据。同样，您也可以使用 subContinent 过滤器及其其中一个有效值修改查询，以检索次大陆（例如西欧或东南亚）的数据。还支持其他过滤条件。结果按查看次数降序排序。

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

美国各类型内容总观看次数排名前 10 的城市

此查询会检索各支持的 creatorContentType 对应的指定日期范围内，在内容所有者所主张版权的内容中获得最多观看次数的 10 个美国城市的列表。结果按查看次数降序排序。

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

美国前 10 大城市（按总观看时长）

此查询检索指定日期范围内最热门的 10 天的列表，如果内容拥有者声明了版权的内容中任何美国城市的每日总观看时长最长。查询结果会标识总观看时长、观看时长的发生日期以及内容估计被观看的城市。结果按总观看时长降序排列。

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 大 - 欧洲观看次数最多的视频

此查询从内容所有者声明了版权的视频（按指定日期范围内的观看次数衡量）中检索欧洲最热门的 10 个视频。可以通过为该过滤条件选择其他有效值，将查询修改为请求另一个大洲的数据。同样，您也可以使用 subContinent 过滤器及其其中一个有效值修改查询，以检索次大陆（例如西欧或东南亚）的数据。结果按查看次数降序排序。

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

播放列表报告

内容所有者的播放列表在特定国家/地区的观看时长指标

此查询会针对内容所有者频道中的所有播放列表，检索在特定国家/地区特有的播放列表观看次数和播放列表观看时长指标。该报告会针对用户观看播放列表的每个国家/地区返回一行数据。各行按观看时长（分钟数）降序排序。

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

十大 - 美国观看次数最多的播放列表

此查询会从内容所有者的频道中检索 10 个在美国观看者在指定日期范围内开始观看最频繁的播放列表。结果按播放列表开始次数降序排序。

注意：由于此报告使用 playlist 维度，因此您必须为 sort 请求参数的值指定一个值，并将 maxResults 参数设置为不超过 10 的整数值。

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

视频报告

“赞”和“踩”的数量（按内容类型）

此查询会检索特定频道或频道组上每种类型内容的“顶”和“踩”次数。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的渠道列表（最多 500 个渠道 ID）。

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

视频报告

不同播放位置的观看次数和观看时长

此查询会检索上传到一个或一组频道的视频的观看次数和估算观看时长。结果根据视频播放所在的网页或应用类型进行汇总，并按观看次数降序排列结果。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的渠道列表（最多 500 个渠道 ID）。

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

不同播放位置的每日观看次数和观看时长

此查询会检索上传至特定频道或频道组的视频在美国的每日观看次数和估算观看时长。系统会按天对发生视频播放的每种网页或应用类型的结果进行分组。结果按时间倒序排序。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的渠道列表（最多 500 个渠道 ID）。

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

排名前 10 - 为嵌入式视频带来最多观看次数的第三方网站

此查询会检索特定视频或一组视频的观看次数和估算观看时长。结果会按嵌入相应视频的第三方网站进行分组。结果按观看次数降序排序。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为一个逗号分隔列表，其中最多包含 500 个您已上传的视频 ID。

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

播放列表报告

来自不同播放位置的播放列表观看次数和观看时长

此查询会检索内容所有者频道中所有播放列表的播放列表观看次数、播放列表估算观看时长和播放列表开始播放的次数。结果按播放视频的网页或应用类型进行汇总，并按播放列表开始次数降序排列结果。

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

来自不同播放位置的播放列表观看次数和观看时长

此查询会针对内容所有者频道中的所有播放列表，检索每日播放列表开始次数、播放列表观看次数和播放列表在美国的估算观看时长。系统会针对发生了播放列表浏览的每种类型的网页或应用返回结果。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

视频报告

不同流量来源的观看次数和观看时长

该请求会检索内容所有者视频的观看次数和估算观看时长。这些指标按流量来源进行汇总，流量来源说明了用户访问视频的方式。

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

不同流量来源带来的每日观看次数和观看时长

该请求会检索内容所有者视频的每日观看次数和每日估算观看时长。系统会按流量来源每天汇总这些指标，并按时间倒序排序。

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

注意：接下来的两个示例报告仅适用于特定流量来源。例如，NO_LINK_EMBEDDED 流量来源没有其他详细信息，因此无法为该来源提供这些报告。有关可提供这些类型的报告的流量来源的详细信息，请查看 insightTrafficSourceType 的定义。

前 10 - 为视频带来最多流量的 YouTube 搜索字词

此查询会检索通过 YouTube 搜索结果为特定视频或视频组带来最多观看次数的 10 个搜索字词。结果按查看次数降序排序。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为一个逗号分隔列表，其中最多包含 500 个您已上传的视频 ID。

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

前 10 - 为视频带来最多流量的外部网站

此查询会检索通过 Google 搜索结果为特定视频或视频组带来最多观看次数的 10 个外部网站。结果按预计观看时长降序排序。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为一个逗号分隔列表，其中最多包含 500 个您已上传的视频 ID。

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

播放列表报告

一个国家/地区中不同流量来源带来的播放列表观看次数和观看时长

此请求会检索指定国家/地区的播放列表观看次数、播放列表开始次数和播放列表估算观看时长。这些指标按流量来源进行汇总，流量来源说明了用户访问播放列表的方式。

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

不同流量来源带来的播放列表观看次数和观看时长

此请求会检索内容所有者的一个或多个频道中播放列表的播放列表观看次数、播放列表开始次数和播放列表估算观看时长。这些指标按流量来源汇总。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为一个逗号分隔列表，其中最多可包含 500 个渠道的渠道 ID。

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

视频报告

已主张版权的视频的每日设备类型指标

此查询会按设备类型检索由特定内容所有者主张的视频的每日观看次数和估算观看时长。系统会按天分组显示有视频播放的每类设备的结果。结果按时间顺序排序。

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

在移动设备上观看的已主张版权的视频的每日操作系统指标

此查询会按操作系统检索由指定内容所有者主张了版权且在移动设备上发生的视频观看次数，并检索每日观看次数和估算观看时长。按天分组显示视频播放情况的各操作系统的结果。结果按时间顺序排序。

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

每日操作系统和设备类型指标

此查询会检索特定内容所有者已声明版权的视频的每日观看次数和估算观看时长。统计信息按操作系统和设备类型分组。结果按时间顺序排序。

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

播放列表报告

Android 操作系统上播放列表观看次数的设备类型指标

此查询会针对内容所有者的一个或多个频道的播放列表，检索 Android 设备上的播放列表观看次数和播放列表估算观看时长。系统会针对发生了播放列表观看的每种设备类型返回结果。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的渠道 ID 列表，最多可包含 500 个渠道。

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

移动设备上播放列表观看次数的操作系统指标

此查询会针对内容所有者的任何频道的播放列表，检索移动设备上的播放列表观看次数和播放列表估算观看时长。系统会针对发生播放列表观看次数的每个操作系统返回结果。

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

视频报告

加利福尼亚州的观看者受众特征（年龄段和性别）

此报告会检索加利福尼亚州观看了内容所有者所声明内容的观看者的年龄段和性别的统计信息。结果先按性别排序，然后按年龄段排序。您可以修改此查询，通过调整 filters 参数值，检索全球所有观看者或某个国家/地区、大洲、次大陆或其他美国州内的所有观看者的相同统计信息。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

分享指标（按分享视频时所用服务汇总）

此请求会检索用户使用“Share”按钮分享内容所有者上传的视频的次数。结果按分享服务（Google+、Twitter 等）汇总，并按分享次数降序排序。

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

视频的观众黏度指标

此报告用于衡量视频留住观众的能力。一次只能为一个视频检索报告。请注意，要在 API Explorer 中运行此查询，您必须将 filters 参数值中的字符串 VIDEO_ID 替换为您上传的某个视频的视频 ID。请注意，观众黏度报告不支持为“video”过滤条件指定多个值。

在此示例中，报告使用 audienceType 过滤器限制响应，使其仅包含自然观看次数的数据，自然观看次数是直接用户操作（例如搜索视频或点击推荐视频）的结果。因此，此报告不包含 TrueView 插播广告或 TrueView 展示广告的观看次数数据。您可以移除过滤条件，以检索视频的观众黏度数据（涵盖所有受众群体类型）。

请注意，audienceType过滤条件的数据自 2013 年 9 月 25 日起已提供。如果查询使用过滤条件来尝试检索较早日期的数据，该 API 不会返回相关数据。不使用该过滤器的查询会应用于 2008 年 7 月 1 日之后的任何日期。

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

已声明版权的内容的收入和广告效果指标

该请求会检索内容所有者已声明版权的内容的收入和广告效果指标。该报告会返回一行数据，其中包含指定日期范围内每个请求的指标的总计值。

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

每日收入和广告效果指标

该请求会检索内容所有者已声明版权的内容的每日收入和广告效果指标。

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

特定国家/地区的收入和广告效果指标

该请求会检索内容所有者已声明版权的内容在特定国家/地区的收入和广告效果指标。结果按收入金额降序排列，这意味着列出的第一个国家/地区将是合作伙伴估算收入最高的国家/地区。

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

十大热门视频 - 收益最高的视频

该请求会检索由内容所有者声明了版权且收入最高的 10 个视频的收入和广告效果指标。结果按收入金额降序排列，这意味着第一个视频将是估算收入最高的视频。

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

不同广告类型的广告效果指标

该请求会检索内容所有者已声明版权的内容的广告效果指标。结果按广告类型分组，便于您比较不同广告类型的收入和每千次展示费用值。

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType