文档中心>腾讯会议>开放平台文档>服务端 API>REST APIs>录制管理>获取会议录制操作(查看、下载)记录

获取会议录制操作(查看、下载)记录

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

我的收藏

接口描述

描述:查询会议录制 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}


输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明
参数名称
必选
参数类型
参数描述
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"
}
]
}