本文导读

展开导读

文档首页/ 视频点播 VOD/ API参考/ 统计分析/ 查询媒资日播放统计数据

查询媒资日播放统计数据

更新时间：2025-02-08 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

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

使用媒资日播放统计查询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	处理失败返回。

错误码

请参见错误码。

父主题： 统计分析

上一篇：查询域名播放日志

下一篇：水印模板管理

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消