接口描述
描述:查询会议录制 ID 对应的操作记录,包括用户查看和下载,支持 OAuth2.0 鉴权调用。
所需权限点为:查看会议录制(VIEW_VIDEO) 或 管理会议录制(MANAGE_VIDEO)。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/records/events?meeting_record_id={meeting_record_id}&start_time={start_time}&end_time={end_time}&event_type={event_type}&page_size={page_size}&page={page}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_record_id | 是 | String | 会议录制 ID,列表接口返回的是 meeting_record_id。 |
event_type | 是 | Integer | 查询事件类型: 1:下载 2:查看 |
page_size | 否 | Integer | 分页大小,默认20,最大50。 |
page | 否 | Integer | 页码,从1开始,默认1。 |
start_time | 否 | Integer | 查询起始时间戳,UNIX 时间戳(单位秒);说明:默认展示最近31天的数据,时间区间不允许超过31天。 |
end_time | 否 | Integer | 查询结束时间戳,UNIX 时间戳(单位秒);说明:默认展示最近31天的数据,时间区间不允许超过31天。 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
total_count | 是 | Integer | 分页查询返回数据总数。 |
current_size | 是 | Integer | 分页查询返回单页数据条数。 |
current_page | 是 | Integer | 分页查询返回当前页码。 |
total_page | 是 | Integer | 分页查询返回分页总数。 |
events | 否 | Event 对象数组 | 事件明细集合。 |
Event 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
operate_time | 是 | Integer | 操作时间,UNIX 时间戳(单位毫秒)。 |
event_type | 是 | Integer | 查询事件类型: 1:下载 2:查看 |
userid | 是 | String | 用户 ID。 |
user_name | 是 | String | 用户名称。 |
record_name | 是 | String | 录制文件名称。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 4049 | 查询单条记录失败,不存在的记录 |
500 | 4044 | 会议录制未完成 |
500 | 403 | 没有资源操作权限。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/records/events?meeting_record_id=13543312320993232421&event_type=2&page_size=20&page=1&start_time=1610985600&end_time=1613664000
输出示例
{"total_count": 2,"current_size": 20,"current_page": 1,"total_page": 1,"events": [{"operate_time": 1613717122000,"event_type": 2,"userid": "test_user1","user_name": "张三","record_name": "录制1"},{"operate_time": 1613804949000,"event_type": 1,"userid": "test_user2","user_name": "李四","record_name": "录制2"}]}