文档首页/ 视频点播 VOD/ API参考/ 统计分析/ 查询媒资日播放统计数据
更新时间:2024-12-12 GMT+08:00

查询媒资日播放统计数据

功能介绍

查询媒资日播放统计数据。

使用媒资日播放统计查询API前,需要先提交工单开通统计功能,才能触发统计任务。

支持查询最近一年的播放统计数据。

URI

GET /v1/{project_id}/asset/daily-summary

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

start_time

String

查询开始时间。仅支持查询一年内的数据,且一次查询的日期跨度不能超过90天。

如果查询指定开始日期的数据,格式为:yyyyMMdd000000。

end_time

String

查询结束时间。仅支持查询一年内的数据,且一次查询的日期跨度不能超过90天。

如果查询指定结束日期的数据,格式为:yyyyMMdd000000。

offset

Integer

偏移量,表示查询该偏移量后面的记录。

limit

Integer

查询返回记录的数量限制。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

记录总数

summary_results

Array of AssetDailySummaryResult objects

日志文件列表

表5 AssetDailySummaryResult

参数

参数类型

描述

date

String

播放日期,格式为:yyyyMMdd000000。

link

String

日播放统计数据文件的下载地址,有效期为12个小时。

文件内容格式:[域名]\t[媒资ID]\t[日期]\t[播放流量]\t[播放次数]

播放次数统计说明:

  • HLS文件:访问M3U8文件时会统计播放次数,访问TS文件时不会统计播放次数。

  • 其它文件:如MP4文件,当播放请求带有range且range的start参数不等于0时,不统计播放次数。其它情况下,会统计播放次数。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

响应示例

状态码: 200

处理成功返回。

{
  "total" : 1,
  "summary_results" : [ {
    "date" : "20231201000000",
    "link" : "http://cdn-log-user-bj4.obs.cn-north-4.myhuaweicloud.com:80/asset-play-summary/05a8aee14d8026a92fcdc018fe235c2c/20231201-asset-play-summary.gz?AccessKeyId=QXBNBGA2GW9EP2XXOYUN&Expires=1701786544&Signature=kZYh0hEos2V**********AHGyXA%3D"
  } ]
}

状态码: 400

处理失败返回。

{
  "error_code" : "VOD.10053",
  "error_msg" : "The request parameter is illegal, illegal field: {xx}."
}

状态码

状态码

描述

200

处理成功返回。

400

处理失败返回。

错误码

请参见错误码