文档中心 云点播 服务端 API 手册 云点播 API 2017 数据统计 查询每日播放 Top100 的视频播放统计数据

查询每日播放 Top100 的视频播放统计数据

最近更新时间:2019-05-10 09:36:50

接口名称

DescribePlayStatTopFiles

功能说明

查询指定日期播放次数 Top100 的视频文件播放统计数据。

  1. 每天上午10:00对前一天的 CDN 日志进行分析生成 Top100 的播放统计数据。如果在11:00前调用,只能查到前天及之前的数据,如果在11:00后调用,可以查询到昨天及之前的数据。
  2. 最多返回100个文件播放统计数据。
  3. 只能查询最近30天内的播放统计数据。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
date String 查询日期,格式为 yyyy-MM-dd ,如2018-03-20。如果是11:00之前调用,date 必须是前天或之前的日期,如果是11:00之后调用,date 可以是昨天或之前的日期
host String 域名,查询该域名的播放统计数据,如果没有带 host 参数,查询所有域名汇总的播放统计数据
COMMON_PARAMS 参见 公共参数
## 接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败
message String 错误信息
data Array 结果数据
data.fileId String 视频 ID
data.name String 视频名称
data.duration Number 视频时长,单位:秒
data.size Integer 视频大小,单位:字节
data.playTimes Integer 播放次数
data.playFlux Integer 播放流量

错误码说明

错误码 含义说明
4000 - 7000 参见 公共错误码
1000 无效参数

示例

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribePlayStatTopFiles
&date=2018-03-20
&COMMON_PARAMS

应答示例

{
    "code": 0,
    "message": "",
    "data": [{
        "fileId": "12333334",
        "name": "test",
        "duration": 233,
        "size": 365213,
        "playTimes": 156,
        "playFlux": 23659784
    }]
}