示例 API 请求

此页面显示了示例 YouTube Analytics API 请求。每个示例都会简要描述要检索的报告,然后显示相应的 dimensionsmetricsfilterssort 参数值。(渠道报告内容所有者报告文档用于标识 API 支持的报告)。

每个示例都链接到 Google API Explorer,并使用显示的值填充它。这些示例还使用了默认开始日期和结束日期 (YYYY-MM-DD),即 2022-01-012022-06-30

关联到 API Explorer 后,您仍需指定要检索报告的渠道或内容所有者。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

播放列表报告

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

此请求检索通过身份验证的用户的频道中的播放列表的总播放列表播放次数、估计观看时长、观看次数以及每个播放列表开始的观看次数。views 指标仅统计在播放列表环境中发生的视频观看次数。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定播放列表的统计信息

此请求会检索特定播放列表的开始总观看次数、估计观看时长、观看次数以及每个播放列表的开始观看次数。views 指标仅统计在播放列表环境中发生的视频观看次数。请注意,要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 PLAYLIST_ID 替换为通过身份验证的用户的频道中的播放列表的播放列表 ID。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

要检索多个播放列表的汇总统计信息,您还可以将字符串 PLAYLIST_ID 替换为通过身份验证的用户的频道中的播放列表(最多 500 个播放列表 ID)的逗号分隔列表。

频道排名前 10 的热门播放列表

此查询会检索某个频道观看次数最多的 10 个播放列表,这是按指定日期范围内估计的观看时长计算得出的。它还检索其他几个播放列表指标,例如观看者启动每个播放列表的次数,以及观看者观看播放列表中视频后的平均时间。结果按估计的观看时间降序排列。

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

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
基于时间

视频报告

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

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

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

频道视频的每日注释指标

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

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

播放列表报告

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

此请求会检索通过身份验证的用户的频道的每日观看次数、播放列表开始观看次数、估算观看时长以及每个播放列表的开始观看次数。结果按时间顺序排序。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
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

按内容类型总观看次数划分的美国十大城市

此查询会检索一个列表,该列表列出了每个指定 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
filters=isCurated==1
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
filters=isCurated==1
sort=-playlistStarts

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

该查询会检索特定频道的播放列表的每日播放列表开始次数、观看次数以及估算的美国观看时长。按播放列表观看的每种网页或应用按天对搜索结果分组。结果按时间顺序排序。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;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,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

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

此请求会检索频道的每日播放列表观看次数、播放列表开始观看次数和播放列表观看次数的估算观看时长。这些指标每天都会按流量来源进行汇总,并按时间顺序排列。

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
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 操作系统上播放列表观看次数的每日设备类型指标

此查询会检索特定频道的播放列表的每日播放列表观看次数和估算的观看时长。按天查看获得观看次数的各类设备的搜索结果。结果按时间顺序排序。

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

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

此查询在移动设备上检索特定频道的播放列表的每日播放列表观看次数和估算观看时长。系统会按发生了播放列表观看次数的每个操作系统按天对结果进行分组。结果按时间顺序排序。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
受众特征

视频报告

加利福尼亚州的受众特征(年龄段和性别)

此报告会检索与观看加利福尼亚州视频的观看者的年龄段和性别有关的统计信息。结果会依次按性别和年龄段排序。通过修改 filters 参数值,可将此查询修改为检索全球所有观看者或者某个国家/地区、洲、次大陆或其他美国各州的观看者具有相同的统计信息。

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

播放列表报告

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

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;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 替换为以英文逗号分隔的频道 ID 列表(最多包含 500 个频道 ID)。

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

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

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

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

播放列表报告

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

此请求用于检索在内容所有者的频道中播放列表的开始总观看次数、估计观看时长、观看次数和每个播放列表开始的观看次数。views 指标仅统计在播放列表环境中发生的视频观看次数。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定频道的播放列表观看次数

此请求用于检索在内容所有者的频道中播放列表的开始总观看次数、估计观看时长、观看次数和每个播放列表开始的观看次数。views 指标仅统计在播放列表环境中发生的视频观看次数。请注意,要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的频道 ID 列表(最多包含 500 个频道 ID)。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

播放列表的统计信息

此请求会检索特定播放列表的开始总观看次数、估计观看时长、观看次数以及每个播放列表的开始观看次数。views 指标仅统计在播放列表环境中发生的视频观看次数。请注意,若要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 PLAYLIST_ID 替换为某个内容所有者频道的播放列表的播放列表 ID。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

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

排名前 10 的内容所有者最常观看的播放列表

此查询会检索内容所有者在前 10 个观看次数最多的播放列表(由指定日期范围内的观看分钟数来衡量)。它还检索其他几个播放列表指标,例如观看者启动每个播放列表的次数,以及观看者观看播放列表中视频后的平均时间。结果按估计的观看时间降序排列。

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

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
基于时间

视频报告

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

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

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

播放列表报告

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

此请求会检索内容所有者频道中的所有播放列表的每日观看次数、播放列表开始观看次数、预估观看时长和每个播放列表的观看次数。结果按时间顺序排序。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
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 而言,内容所有者的收到版权主张的内容的次数最多。结果按观看次数从低到高排序。

    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=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

排名前 10 的美国热门播放列表

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

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

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

视频报告

按内容类型划分的“顶”和“踩”记录

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

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
播放位置

视频报告

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

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

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

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

此查询会检索上传到特定频道或频道组的视频的每日观看次数和估算的观看时长。系统会按播放视频的每种网页或应用类型按天对搜索结果分组。结果按时间倒序排列。请注意,要在 API Explorer 中运行此查询,您必须将 filters 参数值中的字符串 CHANNEL_ID 替换为以英文逗号分隔的频道 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=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

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

此查询会检索内容所有者频道中的所有播放列表的每日播放列表开始次数、观看次数和估算的观看时长。按播放列表观看的每种网页或应用按天对搜索结果分组。结果按时间顺序排序。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
流量来源

视频报告

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

此请求会检索内容所有者的视频的观看次数和估计观看时长。这些指标按流量来源进行汇总,描述了用户到达视频的方式。

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=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
设备/操作系统

视频报告

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

此查询会按设备类型检索特定内容所有者声明的视频的每日观看次数和估计观看时长。系统会按播放视频的各类设备按天对搜索结果分组。结果按时间顺序排序。

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 个频道 ID)。

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

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

此查询会在移动设备上检索某个内容所有者频道中的播放列表的每日播放列表观看次数和估算观看时长。系统会按发生了播放列表观看次数的每个操作系统按天对结果进行分组。结果按时间顺序排序。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
受众特征

视频报告

加利福尼亚州的受众特征(年龄段和性别)

此报告会检索在内容所有者中收到版权主张的内容的观看者的年龄和性别统计信息。结果会依次按性别和年龄段排序。通过修改 filters 参数值,可将此查询修改为检索全球所有观看者或者某个国家/地区、洲、次大陆或其他美国各州的观看者具有相同的统计信息。

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

播放列表报告

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

此报告会检索在任意内容所有者的频道中观看了播放列表的加利福尼亚州观看者的年龄段和性别的统计信息。结果会依次按性别和年龄段排序。通过修改 filters 参数值,可将此查询修改为检索全球所有观看者或者某个国家/地区、洲、次大陆或其他美国各州的观看者具有相同的统计信息。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;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