全部产品
云市场

播放数据均量统计

更新时间:2019-05-31 15:27:31

描述

获取指定时间范围内的每日播放数据均量统计。

注意:

  • 仅支持使用了阿里云点播播放器SDK的播放数据统计。
  • 以北京时间(UTC+8)为基准,每天上午9点生成前一天的播放数据统计。
  • 支持查询 2018-01-01 起的数据,数据查询的起止时间跨度最大为90天。

请求参数

参数 类型 是否必需 描述
Action String

操作接口名,系统规定参数。取值:DescribePlayUserAvg

StartTime String

起始时间

  • UTC格式,例如:2018-01-29T00:00:00Z。
  • 支持查询2018-01-01起的数据,即 StartTime 大于等于 2018-01-01T00:00:00Z。

EndTime String

结束时间。UTC格式,例如:2018-02-01T00:00:00Z。

返回参数

参数 类型 描述
RequestId String

请求ID

UserPlayStatisAvgs UserPlayStatisAvgs

用户每天平均播放均值统计数据

示例

请求示例

  1. https://vod.cn-shanghai.aliyuncs.com?Action=DescribePlayUserAvg
  2. &StartTime=2018-01-01T00:00:00Z
  3. &EndTime=2018-01-03T00:00:00Z
  4. &<公共请求参数>

注意:示例中的“公共参数”参见 公共参数说明文档

正常返回示例

JSON格式

  1. {
  2. {
  3. "UserPlayStatisAvgs": {
  4. "UserPlayStatisAvg": [
  5. {
  6. "AvgPlayDuration": "1035902.8",
  7. "Date": "20180101",
  8. "AvgPlayCount": "17.0"
  9. },
  10. {
  11. "AvgPlayDuration": "3113356.7",
  12. "Date": "20180102",
  13. "AvgPlayCount": "41.0"
  14. },
  15. {
  16. "AvgPlayDuration": "4290368.0",
  17. "Date": "20180103",
  18. "AvgPlayCount": "59.8"
  19. }
  20. ]
  21. },
  22. "RequestId": "6C7F90B2-BDA4-4FAC-BAAD-A38A121DFE19"
  23. }
  24. }

异常返回示例

JSON格式

  1. {
  2. "Code":"InvalidStartTime.Malformed",
  3. "HostId":"vod.cn-shanghai.aliyuncs.com",
  4. "Message":"Specified StartTime is malformed.",
  5. "RequestId":"1FAFB884-D5A7-47D1-82B5-8928AA9C8720"
  6. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码 错误信息 HTTP 状态码 说明
InternalError The request processing has failed due to some unknown error. 500 后台发生未知错误。
InvalidStartTime.Malformed Specified StartTime is malformed. 400 StartTime格式错误,应为UTC格式,例如:2018-06-29T19:00:00Z。
InvalidEndTime.Malformed Specified EndTime is malformed. 400 EndTime格式错误,应为UTC格式,例如:2018-06-30T19:00:00Z。
InvalidEndTime.BeyondCurrent EndTime beyond current time. 400 EndTime不能超过当前时间。
InvalidEndTime.Mismatch StartTime or EndTime is mismatch. 400 StartTime和EndTime不匹配。