服务端 API 文档

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

最近更新时间:2019-10-25 09:52:30

接口名称

GetPlayStatLogList

功能说明

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

  • 每天上午11:00左右生成前一天的播放统计文件。
  • 只能查询最近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 总的播放次数。
pc_play_times PC 端播放次数。
mobile_play_times 移动端播放次数。
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"
        }
    ]
}
目录