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

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

最近更新时间:2019-07-16 09:59:20

接口名称

DescribePlayStatTopFiles

功能说明

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

  • 每天上午10:00对前一天的 CDN 日志进行分析生成 Top100 的播放统计数据。
  • 如果在11:00前调用,则只能查到前天及之前的数据;如果在11:00后调用,则可以查询到昨天及之前的数据。
  • 最多返回100个文件播放统计数据。
  • 只能查询最近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 - 请参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribePlayStatTopFiles
&date=2018-03-20
&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 无效参数。

应答示例

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