获取账户级会议录制列表

最近更新时间:2024-11-11 09:42:21

我的收藏
说明:
账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:10次/min。

接口描述

描述:获取账户的云录制记录,根据企业 ID 进行查询,支持根据时间区间分页获取。暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
自建应用权限点:查看企业录制,管理企业录制。
接口操作者权限点:需具备录制管理的查看/编辑权限,可登录 管理后台 通过如下路径查看:账户管理 > 录制管理 > 查看/编辑权限。
接口请求域名:
https://api.meeting.qq.com/v1/corp/records?start_time={start_time}&end_time={end_time}&page_size={page_size}&page={page}&operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明
参数名称
必选
参数类型
参数描述
page_size
Integer
分页大小,默认10,最大20。
page
Integer
页码,从1开始,默认1。
start_time
Integer
查询起始时间戳,UNIX 时间戳(单位秒);说明:时间区间不允许超过31天。
end_time
Integer
查询结束时间戳,UNIX 时间戳(单位秒);说明:时间区间不允许超过31天。
query_record_type
Integer
录制文件类型,默认为 1。
0:全部
1:云录制
2:上传录制
operator_id
String
操作者 ID。
operator_id_type
Integer
操作者 ID 类型。
1:userid

输出参数

参数名称
必选
参数类型
参数描述
total_count
Integer
分页查询返回数据总数。
current_size
Integer
分页查询返回单页数据条数。
current_page
Integer
分页查询返回当前页码。
total_page
Integer
分页查询返回分页总数。
record_meetings
RecordMeetings 对象数组
会议录制列表。

RecordMeetings 对象

参数名称
必选
参数类型
参数描述
meeting_record_id
String
会议录制 ID。
meeting_id
String
会议 ID。
meeting_code
String
会议 code。
userid
String
会议创建者用户 ID。
media_start_time
Number
会议开始时间,UNIX 时间戳(单位毫秒)。
subject
String
会议主题。
state
Integer
录制状态:
1:录制中
2:转码中
3:转码完成
当状态为转码完成才会返回录制文件列表。
record_type
Integer
返回的录制文件类型。
0:云录制
2:上传录制
record_files
RecordFiles 对象数组
录制文件列表。

RecordFiles 对象

参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID。
record_start_time
Number
开始录制时间,UNIX 时间戳(单位毫秒)。
record_end_time
Number
结束录制时间,UNIX时间戳(单位毫秒)。
record_size
Number
文件大小(单位字节)。
sharing_state
Integer
共享状态,是否开启共享。
0:未开启
1:开启
当开启共享时,则返回共享链接、访问权限、访问密码、共享链接有效期、是否允许下载。
sharing_url
String
共享链接,开启共享时返回。
required_same_corp
bool
仅企业用户可查看,开启共享时返回。
required_participant
bool
仅参会成员可查看,开启共享时返回。
password
String
访问密码,开启共享时返回。
sharing_expire
Number
共享链接有效期(单位毫秒),开启共享时返回;当未开启共享链接有效期时,返回0表示永久有效。
view_address
String
播放地址,开启共享时返回。
allow_download
bool
是否允许下载,开启共享时返回。
download_address
String
下载地址,过期时间6小时,允许下载和开启共享时返回。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
500
41
网络超时。
400
500014
账号无权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/corp/records?start_time=1611072000&end_time=1613750400&page_size=10&page=1&operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1

输出示例

{
"total_count": 2,
"current_size": 10,
"current_page": 1,
"total_page": 1,
"record_meetings": [
{
"meeting_record_id": "1362742106631111111",
"meeting_id": "6249027861881211111",
"meeting_code": "29858611111",
"media_start_time": 1613738006000,
"subject": "test的快速会议",
"userid":"test",
"state": 3,
"record_type":0,
"record_files": [
{
"record_file_id": "1362742106635911111",
"record_start_time": 1613738011389,
"record_end_time": 1613743058603,
"record_size": 480236476,
"sharing_state": 1,
"sharing_url": "https://pre.txmeeting.tencent.com/user-center/shared-record-info?id=20bccca4-7bb5-4507-9b24-03111fd78515",
"required_same_corp": false,
"required_participant": true,
"password": "HHz4yo6d",
"sharing_expire": 0,
"view_address":"https://.....",
"allow_download": false
}
]
},
{
"meeting_record_id": "1362741760987500000",
"meeting_id": "18113044044021111111",
"meeting_code": "130156111",
"media_start_time": 1613737924000,
"subject": "test的快速会议",
"userid":"test",
"state": 3,
"record_type":0,
"record_files": [
{
"record_file_id": "1362231760987501111",
"record_start_time": 1613737928980,
"record_end_time": 1613737944556,
"record_size": 1075029,
"sharing_state": 1,
"sharing_url": "https://pre.txmeeting.tencent.com/user-center/shared-record-info?id=fg25a7ef-326f-4a28-853c-4721dc6e0eb7",
"required_same_corp": false,
"required_participant": true,
"password": "Hwqbwpk8",
"sharing_expire": 0,
"allow_download": true,
"download_address": "https://yunluzhi-pre-az-1258344699.file.myqcloud.com/cos/1410212767/1362741760987504640/13627244760987504641/TM-20210219203204-130156700-recording-1.mp4?token=eJxsj1GTmjAURv9LngvchJAAM33orl3XXdStsnT1xUGCGgoJQpBCt_-901anL30938y95_xAcbS207redVKgEHVS7JRWWY4-_F0yI7VCIZroXpU6Fe8nY-o2dJyhU2U3nqRVN7mVjhYmnu9SyoLAPsgyt6vhnJW6E3amKyfTrYMpAMGEM-5glxFOMWcQ-NwDyij8h2EnnlsECAaCAwIuAWphF7DHOIDV5JluhFRHC9tVTd_x1bgV33ZpXf-p-ffyOpqhzlGIVp_vl6vJbDG9YVn9xphh1wcfuH-7JY8oRNWza-Yvl6UR8nB6gmBb7vdbwR-oSu699cp7GIPMlM3EFWcxFZ4s346TPtoUbwnphEthPfTTBzOqxIlVO3obPy285LVoe6Z6UnyK7i50Ulss8gc-NZBtOt_qZHhY4itvZEecZ_7okL-doCuaUyiSaxcGSvg5fiH4cL09O9Ojsm0K5d0PWruHjVTz_Xssm36UHkze3MBIw7qOfvwIAAP__vu2VQQ"
}
]
}
]
}