文档中心 云点播 服务端 API 手册 云点播 API 2017 数据统计 获取播放统计数据文件下载地址

获取播放统计数据文件下载地址

最近更新时间:2019-03-20 12:44:21

接口名称

GetPlayStatLogList

功能说明

  1. 查询每天的播放统计文件下载地址。
  2. 点播每天对前一天的 CDN 请求日志进行分析处理,生成该日的播放统计文件。播放统计文件内容包含了视频文件的播放次数和播放流量、客户端 IP 等统计信息。
  3. 播放统计数据的说明:
    1)对 hls 文件,m3u8 文件被请求时统计播放次数,ts 文件被请求时只统计流量,不统计播放次数。
    2)非 hls 文件,如 mp4 文件,当请求带 range 参数时,如果 range 的 start 为0,统计播放次数,否则不统计播放次数;如果请求没有带 range 参数,会统计播放次数。
    3)统计数据中的客户端 IP 数为去重后的客户端 IP 总数。
    4)播放设备的统计数据,如果 HTTP 请求中带了 UserAgent 参数,并且 UserAgent 包含了 Android 或者 iPhone 等标识,就会统计为移动端播放次数,否则统计为 PC 端播放次数。
    5)文件播放流量是从 CDN 日志里的回包字节数累计得到的,这个流量数据和控制台上查到的或者统计 API 查询到的流量数据来源是不一样的,控制台的流量数据是从 CDN 节点机器网卡取到的数据,两者存在差异。

注意

  1. 每天上午11:00左右生成前一天的播放统计文件
  2. 只能查询最近30天内的播放统计文件

事件通知

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
from String 开始日期,如2017-09-01
to String 结束日期,如2017-09-10
COMMON_PARAMS - 参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=GetPlayStatLogList
&from=2017-09-01
&to=2017-09-10
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码, 0: 成功, 其他值: 失败
message String 错误信息
fileList Array 播放统计文件列表,每个元素代表一个播放统计文件
fileList.date String 播放统计数据的日期
fileList.url String 播放统计文件下载地址,24小时内有效。播放统计文件为 gzip 压缩的 csv 文件

播放统计文件数据列说明

列名 说明
date 播放日期
file_id 视频文件 ID
ip_count 去重后的客户端 IP 数
flux 播放流量,单位:字节( byte )
play_times 总的播放次数
play_times_pc PC 端播放次数
play_times_mobile 移动端播放次数
iphone_play_times iPhone 端播放次数
android_play_times Android 端播放次数
host_name 点播域名

错误码说明

错误码 含义说明
4000-7000 参见公共错误码
1000 无效参数
1001 用户信息错误

应答示例

{
    "code": 0,
    "message": "",
    "fileList": [
        {
            "date": "2017-09-01",
            "url": "http://xxx.test.com/playstat/20170901.csv.gz?sign=abc"
        }
    ]
}