DescribePlayVideoStatis - 单视频播放数据统计 - 视频点播

调用DescribePlayVideoStatis获取指定视频在指定时间范围内的每日播放统计数据。

接口说明

说明

目前服务地址仅支持：华东2（上海）。

仅支持统计使用了阿里云点播播放器SDK的播放数据。

以北京时间（UTC+8）为基准，每天上午9点生成前一天的播放数据统计。

仅支持最近2年内（730天）的数据查询，且数据查询的起止时间跨度最大为180天。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
StartTime	string	是	指定时间段的起始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2016-06-29T13:00:00Z
EndTime	string	是	指定时间段的结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2016-06-30T13:00:00Z
VideoId	string	是	指定视频的视频ID。	2a8d4cb9ecbb487681473****aba8fda

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求ID。	A92D3600-A3E7-43D6-****-B6E3B4A1FE6B
VideoPlayStatisDetails	array	指定视频每天统计数据。
	object
PlayDuration	string	播放时长。单位：毫秒。	967277
Date	string	日期。格式为：yyyyMMdd。	20170120
VV	string	播放次数。	24
Title	string	视频名称。	4路（1路加密）：流畅-HLS+标清-MP4+高清-HLS-加密+超清-MP4
UV	string	播放用户数。	1
PlayRange	string	播放时长分布。	<=1m:79.2%;>1<=5m:16.7%;>5<=10m:4.2%

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=DescribePlayVideoStatis
&StartTime=2016-06-29T13:00:00Z
&EndTime=2016-06-30T13:00:00Z
&VideoId=2a8d4cb9ecbb487681473****aba8fda
&<公共请求参数>

正常返回示例

JSON格式

{"VideoPlayStatisDetails":{"VideoPlayStatisDetail":[{"PlayRange":"<=1m:79.2%;>1<=5m:16.7%;>5<=10m:4.2%","VV":"24","UV":"1","PlayDuration":"967277","Title":"4路（1路加密）：流畅-HLS+标清-MP4+高清-HLS-加密+超清-MP4","Date":"20170120"}]},"RequestId":"A92D3600-A3E7-43D6-****-B6E3B4A1FE6B"}

XML格式

<DescribePlayVideoStatisResponse>
	<RequestId>A92D3600-A3E7-43D6-****-B6E3B4A1FE6B</RequestId>
	<VideoPlayStatisDetails>
		<VideoPlayStatisDetail>
			<Date>20180101</Date>
			<PlayDuration>3288</PlayDuration>
			<PlayRange>&lt;=1m:79.2%;&gt;1&lt;=5m:16.7%;&gt;5&lt;=10m:4.2%</PlayRange>
			<Title>4路（1路加密）：流畅-HLS+标清-MP4+高清-HLS-加密+超清-MP4</Title>
			<UV>1</UV>
			<VV>1</VV>
		</VideoPlayStatisDetail>
		<VideoPlayStatisDetail>
			<Date>20180102</Date>
			<PlayDuration>967277</PlayDuration>
			<PlayRange>&lt;=1m:79.2%;&gt;1&lt;=5m:16.7%;&gt;5&lt;=10m:4.2%</PlayRange>
			<Title>4路（1路加密）：流畅-HLS+标清-MP4+高清-HLS-加密+超清-MP4</Title>
			<UV>1</UV>
			<VV>24</VV>
		</VideoPlayStatisDetail>
	</VideoPlayStatisDetails>
</DescribePlayVideoStatisResponse>

错误码

访问错误中心查看更多错误码。

接口错误码

下表列举了本接口特有的错误码。

错误代码	错误信息	HTTP 状态码	说明
InternalError	The request processing has failed due to some unknown error.	500	后台发生未知错误。
InvalidStartTime.Malformed	Specified StartTime is malformed.	400	StartTime格式错误，应为UTC时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
InvalidEndTime.Malformed	Specified EndTime is malformed.	400	EndTime格式错误，应为UTC时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
InvalidEndTime.BeyondCurrent	EndTime beyond current time.	400	EndTime不能超过当前时间。
InvalidEndTime.Mismatch	StartTime or EndTime is mismatch.	400	StartTime和EndTime不匹配。