文档首页/ 视频点播 VOD/ API参考/ 统计分析/ 查询媒资日播放统计数据
更新时间：2024-12-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询媒资日播放统计数据

功能介绍

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

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

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

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

处理失败返回。

错误码

请参见错误码。

父主题： 统计分析

相关文档