查询录制文件访问数据

最近更新时间:2024-07-08 11:48:52

我的收藏

接口描述

描述:查询会议录制 ID 对应的访问数据,按照天维度返回,支持 OAuth2.0 鉴权调用。
所需权限点为:查看会议录制(VIEW_VIDEO) 或 管理会议录制(MANAGE_VIDEO)。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/metrics/records?meeting_record_id={meeting_record_id}&start_time={start_time}&end_time={end_time}


输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_record_id
String
会议录制 ID。
说明:查询会议录制列表返回的 meeting_record_id。
start_time
Integer
查询起始时间戳,UNIX 时间戳(单位秒)。
说明:默认展示最近31天的数据,时间区间不允许超过31天。
end_time
Integer
查询结束时间戳,UNIX 时间戳(单位秒)。
说明:默认展示最近31天的数据,时间区间不允许超过31天。

输出参数

参数名称
必选
参数类型
参数描述
summaries
Summary 对象数组
概览数据集合。

Summary 对象

参数名称
必选
参数类型
参数描述
date
String
统计时间,格式:yyyy-MM-dd。
view_counts
Integer
观看次数(当天数据),默认0。
download_counts
Integer
下载次数(当天数据),默认0。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
500
4049
查询单条记录失败,不存在的记录。
500
403
没有资源操作权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/metrics/records?meeting_record_id=135433123209931232425&start_time=1610985600&end_time=1613664000


```plaintext

#### 输出示例

```plaintext
{
"summaries": [
{
"date": "2021-01-19",
"view_counts": 7,
"download_counts": 3
},
{
"date": "2021-01-20",
"view_counts": 23,
"download_counts": 5
},
{
"date": "2021-01-21",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-22",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-23",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-24",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-25",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-26",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-27",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-28",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-29",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-30",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-01-31",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-01",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-02",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-03",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-04",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-05",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-06",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-07",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-08",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-09",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-10",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-11",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-12",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-13",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-14",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-15",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-16",
"view_counts": 20,
"download_counts": 102
},
{
"date": "2021-02-17",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-18",
"view_counts": 0,
"download_counts": 0
},
{
"date": "2021-02-19",
"view_counts": 1,
"download_counts": 1
}
]
}