本页面显示了 YouTube Analytics API 请求示例。每个示例都简要介绍要检索的报告,然后显示相应的 dimensions
、metrics
、filters
和 sort
参数值。(频道报告和内容所有者报告文档指出了该 API 支持的报告。)
每个示例都会链接到 Google APIs Explorer,并使用显示的值填充它。这些示例还使用了 2023-09-01
和 2024-03-31
这二者的默认开始日期和结束日期 (YYYY-MM-DD
)。
关联到 API Explorer 后,您仍然必须指定您要检索其报告的渠道或内容所有者。API Explorer 将使用 channel==MINE
或 contentOwner==CONTENT_OWNER_ID
填充 ids
参数值,具体取决于您点击的查询。对于频道报告,您可以将 MINE
更改为经过身份验证的用户的频道 ID。对于内容所有者报告,您需要将 CONTENT_OWNER_ID
替换为您的内容所有者 ID。
您还必须以指定频道或内容所有者的身份进行身份验证,以便 API Explorer 可以使用 OAuth 2.0 为您的 API 请求授权。
按多个维度/指标对请求进行排序
该 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 个视频(根据指定日期范围内的估算观看分钟数来衡量)。结果按估计观看时长降序排序。
注意:此报告要求您指定 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
替换为以英文逗号分隔的列表,该列表包含经过身份验证的用户频道的播放列表的播放列表 ID(最多包含 500 个 ID)。
十大热门播放列表 - 频道中观看次数最多的播放列表
此查询检索频道中观看次数最多的 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
十大热门 - 为嵌入视频带来最多观看次数的第三方网站
此查询可以检索特定视频或一组视频的观看次数和估算观看时长。系统会按嵌入视频的第三方网站对结果进行分组。结果按观看次数降序排序。请注意,要在 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 个外部网站。结果按预计观看时长降序排序。请注意,要在 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
替换为以英文逗号分隔的渠道 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
播放列表报告
内容所有者频道的播放列表观看次数
此请求会检索播放列表总开始次数、播放列表估计观看时长、播放列表
和播放列表每次开始播放产生的观看次数。通过
“playlistViews
”指标只统计在
播放列表。由于所有请求的指标都是播放列表内指标,因此该请求不会
还需要添加播放列表或群组过滤条件。
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
特定播放列表的统计信息
此请求会检索播放列表的总开始播放次数、估计观看时长、观看次数(
汇总视频指标),
播放列表观看次数(播放列表内指标)、
特定播放列表每次开始播放后的观看次数和观看次数。请注意,要在 API 中
Explorer 中,您必须替换 filters
中的字符串 PLAYLIST_ID
将参数值替换为内容所有者某个频道中播放列表的 ID。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
要检索多个播放列表的汇总统计信息,您还可以将字符串 PLAYLIST_ID
替换为一个逗号分隔列表,该列表包含内容所有者频道中的播放列表的播放列表 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
播放列表报告
内容所有者的每日播放列表观看次数
该请求会检索用户每天与内容所有者的 播放列表。报告中检索到的指标包括 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
替换为以英文逗号分隔的渠道 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
十大热门 - 为嵌入视频带来最多观看次数的第三方网站
此查询可以检索特定视频或一组视频的观看次数和估算观看时长。系统会按嵌入视频的第三方网站对结果进行分组。结果按观看次数降序排序。请注意,要在 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
十大热门 – 为视频带来最多流量的外部网站
此查询检索在 Google 搜索结果中为特定视频或一组视频带来最多观看次数的外部网站。结果按预计观看时长降序排序。请注意,要在 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 个渠道 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
分享指标(按分享视频的服务汇总)
此请求会检索用户使用 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 大 – 收益最高的视频
该请求检索由内容所有者声明了版权并且收入最高的 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