调用DescribePlayVideoStatis获取指定视频在指定时间范围内的每日播放统计数据。
- 目前服务地址仅支持:华东2(上海)。
- 仅支持统计使用了阿里云点播播放器SDK的播放数据。
- 以北京时间(UTC+8)为基准,每天上午9点生成前一天的播放数据统计。
- 仅支持最近2年内(730天)的数据查询,且数据查询的起止时间跨度最大为180天。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePlayVideoStatis |
系统规定参数。取值:DescribePlayVideoStatis。 |
StartTime | String | 是 | 2016-06-29T13:00:00Z |
指定时间段的起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 是 | 2016-06-30T13:00:00Z |
指定时间段的结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
VideoId | String | 是 | 2a8d4cb9ecbb487681473****aba8fda |
指定视频的视频ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | A92D3600-A3E7-43D6-****-B6E3B4A1FE6B |
请求ID。 |
VideoPlayStatisDetails | Array of VideoPlayStatisDetail |
指定视频每天统计数据。 |
|
VideoPlayStatisDetail | |||
PlayDuration | String | 967277 |
播放时长。单位:毫秒。 |
Date | String | 20170120 |
日期。格式为:yyyyMMdd。 |
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
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribePlayVideoStatisResponse>
<RequestId>A92D3600-A3E7-43D6-****-B6E3B4A1FE6B</RequestId>
<VideoPlayStatisDetails>
<VideoPlayStatisDetail>
<Date>20180101</Date>
<PlayDuration>3288</PlayDuration>
<PlayRange><=1m:79.2%;>1<=5m:16.7%;>5<=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><=1m:79.2%;>1<=5m:16.7%;>5<=10m:4.2%</PlayRange>
<Title>4路(1路加密):流畅-HLS+标清-MP4+高清-HLS-加密+超清-MP4</Title>
<UV>1</UV>
<VV>24</VV>
</VideoPlayStatisDetail>
</VideoPlayStatisDetails>
</DescribePlayVideoStatisResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/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"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
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不匹配。 |