DescribePlayVideoStatis - 单视频播放数据统计

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

接口说明

说明
  • 目前服务地址仅支持:华东2(上海)
  • 仅支持统计使用了阿里云点播播放器SDK的播放数据。
  • 以北京时间(UTC+8)为基准,每天上午9点生成前一天的播放数据统计。
  • 仅支持最近2年内(730天)的数据查询,且数据查询的起止时间跨度最大为180天。
  • 调试

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

    调试

    授权信息

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

    请求参数

    名称类型必填描述示例值
    StartTimestring

    指定时间段的起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

    2016-06-29T13:00:00Z
    EndTimestring

    指定时间段的结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

    2016-06-30T13:00:00Z
    VideoIdstring

    指定视频的视频ID。

    2a8d4cb9ecbb487681473****aba8fda

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求ID。

    A92D3600-A3E7-43D6-****-B6E3B4A1FE6B
    VideoPlayStatisDetailsarray

    指定视频每天统计数据。

    object
    PlayDurationstring

    播放时长。单位:毫秒。

    967277
    Datestring

    日期。格式为:yyyyMMdd

    20170120
    VVstring

    播放次数。

    24
    Titlestring

    视频名称。

    4路(1路加密):流畅-HLS+标清-MP4+高清-HLS-加密​​​+超清-MP4
    UVstring

    播放用户数。

    1
    PlayRangestring

    播放时长分布。

    <=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 状态码说明
    InternalErrorThe request processing has failed due to some unknown error.500后台发生未知错误。
    InvalidStartTime.MalformedSpecified StartTime is malformed.400StartTime格式错误,应为UTC时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。
    InvalidEndTime.MalformedSpecified EndTime is malformed.400EndTime格式错误,应为UTC时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。
    InvalidEndTime.BeyondCurrentEndTime beyond current time.400EndTime不能超过当前时间。
    InvalidEndTime.MismatchStartTime or EndTime is mismatch.400StartTime和EndTime不匹配。
    阿里云首页 视频点播 相关技术圈