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

说明
  • 目前仅支持上海地域。
  • 仅支持统计使用了阿里云点播播放器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
Date String 20170120

日期。格式为：yyyyMMdd。

PlayDuration String 967277

播放时长。单位：毫秒。
PlayRange String <=1m:79.2%;>1<=5m:16.7%;>5<=10m:4.2%

播放时长分布。
Title String 4路（1路加密）：流畅-HLS+标清-MP4+高清-HLS-加密​​​+超清-MP4

视频名称。
VV String 24

播放次数。
UV String 1

播放用户数。

示例

请求示例

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

正常返回示例

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>

JSON 格式 

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

错误码

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

接口错误码

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

错误代码

错误信息

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不匹配。