示例 API 请求

本页面显示了 YouTube Analytics API 请求示例。每个示例都简要介绍了要检索的报告,然后显示了相应的 dimensionsmetricsfilterssort 参数值。(频道报告内容所有者报告文档指出了该 API 支持的报告。)

每个示例都会链接到 Google API Explorer,并使用所显示的值填充该工具。这些示例还使用了 2023-09-012024-03-31 这二者的默认开始日期和结束日期 (YYYY-MM-DD)。

关联到 API 浏览器后,您仍然需要指定要检索报告的频道或内容所有者。API Explorer 将使用 channel==MINEcontentOwner==CONTENT_OWNER_ID 填充 ids 参数值,具体取决于您点击的查询。对于频道报告,您可以将 MINE 更改为经过身份验证的用户的频道 ID。对于内容所有者报告,您需要将 CONTENT_OWNER_ID 替换为您的内容所有者 ID。

您还必须经过身份验证,以便作为指定频道或内容所有者进行身份验证,以便 API Explorer 可以使用 OAuth 2.0 授权您的 API 请求。

  1. 按多个维度/指标对请求进行排序
  2. 频道报告
  3. 内容所有者报告

按多个维度/指标对请求进行排序

该 API 支持使用多个维度或指标对响应数据进行排序。例如,以下请求会检索特定频道视频的每日流量来源数据。结果集中的每一行都标识了特定日期来自特定类型流量来源(例如 EXT_URL)的观看次数和估算观看时长。

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

在响应中,结果会按时间顺序排序。每天的结果集中,结果会按观看次数从高到低排序。因此,结果集中的第一行包含在所请求日期范围的第一天产生了最多浏览量的流量来源的数据。第二行包含第一天次数排名第二的流量来源的数据。

渠道报告

基本统计信息

视频报告

频道的总观看次数、估算的观看时长等

此查询会检索频道内容的汇总指标。该报告会返回一行数据,其中包含指定日期范围内每个请求的指标的总和。

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

频道在特定国家/地区的观看次数及其他数据

此查询检索频道视频特定国家/地区的指标。该报告会返回一行数据,其中包含指定日期范围内每个请求的指标的总和。

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

前 10 名 - 频道中观看次数最多的视频

此查询会检索频道中观看次数最多的 10 个视频,以指定日期范围内的估算观看时长为衡量依据。结果会按预计观看分钟数降序排列。

注意:若要生成此报告,您需要为 sort 请求参数指定值,并将 maxResults 参数设置为不超过 10 的整数值。

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

前 10 名 - 频道观看次数最多的视频的注释点击率

此请求会检索频道中观看次数最多的 10 个视频的观看次数、注释点击率、注释关闭率和注释展示次数。结果会按观看次数从高到低排序,也就是说,观看次数最多的视频会排在前面。

注意:若要生成此报告,您需要为 sort 请求参数指定值,并将 maxResults 参数设置为不超过 10 的整数值。

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

播放列表报告

频道的播放列表总观看次数

此请求会检索已验证用户频道中播放列表的总播放次数、预估观看分钟数、观看次数(汇总视频指标)、播放列表观看次数(播放列表内指标),以及每次播放列表开始观看所带来的观看次数。

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

特定播放列表的统计信息

此请求会检索特定播放列表的总播放列表开始播放次数、估计观看时长、观看次数(汇总视频指标)、播放列表观看次数(播放列表内指标)和每次播放列表每次开始播放时的观看次数。请注意,若要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 PLAYLIST_ID 替换为经过身份验证的用户频道中播放列表的播放列表 ID。

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

如需检索多个播放列表的汇总统计信息,您还可以将字符串 PLAYLIST_ID 替换为逗号分隔的列表,其中包含已验证用户频道中最多 500 个播放列表的 ID。

前 10 名 - 频道最受欢迎的播放列表

此查询检索频道中观看次数最多的 10 个播放列表(根据指定日期范围内播放列表观看次数来衡量)。它还会检索其他一些播放列表指标,例如观看者发起播放每个播放列表的次数,以及观看者在播放列表开始播放后观看其中视频的平均时长。结果按播放列表观看次数降序排序。

注意:由于此报告使用的是 playlist 维度,因此您必须为 sort 请求参数指定一个值,同时将 maxResults 参数设置为 10 或更小的整数值。

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews
基于时间

视频报告

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

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

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 天列表。查询结果会显示总观看时长、观看时长发生的日期,以及内容的预计观看城市。结果会按总观看时长降序排列。

    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 名 - 美国启动次数最多的播放列表

此查询检索指定日期范围内美国观看者开始最常观看的 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=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 名 - 收入最高的视频

此请求会检索频道中收入最高的 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

内容所有者报告

基本统计信息

视频报告

所有已声明版权的内容的总观看次数、估算观看时长等

此查询会检索内容所有者收到版权主张的内容的汇总指标。报告会返回一行数据,其中包含指定日期范围内所请求的每个指标的总计值。

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

所有自行上传的视频的按国家/地区划分的观看次数等信息

此查询会检索内容所有者上传的视频在特定国家/地区的指标。该报告会返回一行数据,其中包含指定日期范围内每个请求的指标的总和。

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

所有收到版权主张的第三方内容的总观看次数等信息

此查询会检索内容所有者声明但并未上传的视频的汇总指标。该报告会返回一行数据,其中包含指定日期范围内每个请求的指标的总和。

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

所有自行上传内容的总观看次数等信息

此查询会检索内容所有者上传的视频的汇总指标。报告会返回一行数据,其中包含指定日期范围内所请求的每个指标的总计值。

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

所有已声明所有权且自行上传的内容的总观看次数等信息

此查询会检索内容所有者上传且已声明版权的视频的汇总指标。报告会返回一行数据,其中包含指定日期范围内所请求的每个指标的总计值。

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

前 10 名 - 内容所有者的观看次数最多的视频

此查询会检索内容所有者上传的观看次数最多(以指定日期范围内的观看次数衡量)的 10 个视频。结果会按观看次数降序排列。

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

前 10 名 - 内容所有者的观看次数最多的视频

此查询会检索内容所有者上传的观看次数最多的 10 个视频(以指定日期范围内的估算观看分钟数衡量)。结果会按预计观看时长降序排列。

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

前 10 名 - 内容所有者频道中观看次数最多的视频

此查询会检索内容所有者管理的特定频道或频道组中观看次数最多的 10 个视频。结果会按观看次数降序排列。请注意,若要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为包含最多 500 个渠道 ID(以英文逗号分隔)的列表。

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

前 10 名 - 频道观看次数最多的视频的注释点击率

此请求会检索指定频道或频道组中观看次数最多的 10 个视频的观看次数、注释点击率、注释关闭率和注释展示次数。结果会按观看次数从高到低排序,也就是说,观看次数最多的视频会排在前面。请注意,若要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的列表,其中包含最多 500 个渠道 ID。

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

播放列表报告

内容所有者频道的播放列表观看次数

此请求会检索内容所有者频道中播放列表的总播放次数、播放列表的预计观看分钟数、播放列表观看次数,以及每次播放列表开始观看所带来的观看次数。playlistViews 指标仅统计在播放列表中发生的视频观看次数。由于请求的所有指标都是播放列表内指标,因此请求无需再包含播放列表过滤条件。

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

特定播放列表的统计信息

此请求会检索特定播放列表的播放列表开始次数、预估观看分钟数、观看次数(汇总视频指标)、播放列表观看次数(播放列表内指标)和每次播放列表开始产生的观看次数。请注意,要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 PLAYLIST_ID 替换为内容所有者某个频道中播放列表的 ID。

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

如需检索多个播放列表的汇总统计信息,您还可以将字符串 PLAYLIST_ID 替换为内容所有者频道中播放列表的最多 500 个播放列表 ID 的逗号分隔列表。

基于时间

视频报告

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

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

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

播放列表报告

内容所有者的每日播放列表浏览量

该请求会检索用户每天与内容所有者播放列表中的视频互动的指标。报告中检索的指标包括playlistViewsplaylistStartsplaylistEstimatedMinutesWatchedviewsPerPlaylistStart。所有这些指标都是播放列表内指标。 由于请求的所有指标都是播放列表内指标,因此请求不需要包含播放列表群组过滤条件。

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 名 - 美国启动次数最多的播放列表

此查询会从内容所有者的频道中检索在指定日期范围内美国观看者开始观看频率最高的 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

注意:下两个示例报告仅适用于特定的流量来源。VIDEO_REMIXESNOTIFICATIONEND_SCREENCAMPAIGN_CARDVIDEO_REMIXESNO_LINK_EMBEDDED 流量来源是其中一些不受支持的来源。

前 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 替换为包含最多 500 个渠道 ID(以英文逗号分隔)的列表。

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
观众黏度

视频的观众黏度指标

此报告衡量的是视频在吸引受众群体方面的吸引力。一次只能检索一个视频的报告。请注意,若要在 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 名 - 收入最高的视频

该请求检索由内容所有者声明了版权并且收入最高的 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