接口描述
描述:查询会议录制 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}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
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}]}