查询会议录制地址

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

我的收藏

接口描述

描述:
查询会议录制地址,可获取会议云录制的播放地址和下载地址。
企业 secret 鉴权用户可获取该用户所属企业下的会议录制地址,OAuth2.0 鉴权用户只能获取该企业下 OAuth2.0 应用的会议录制地址。
当您想实时监测会议录制相关状况时,您可以通过订阅 录制管理 中的相关事件,接收事件通知。
当前同一场会议的不同录制文件共用分享链接。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/addresses?meeting_record_id={meeting_record_id}&userid={userid}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
meeting_record_id
String
会议录制 ID,列表返回 meeting_record_id。
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
说明:userid 字段和 operator_id 字段二者必填一项。若两者都填,以 operator_id 字段为准。
operator_id_type
Integer
操作者 ID 的类型:
3:rooms_id
说明:当前仅支持 rooms_id。如操作者为企业内 userid 或 openId,请使用 userid 字段。
userid
String
操作者 ID,仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。
企业唯一用户标识说明
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建用户接口时传递的 userid 参数。
page_size
Integer
分页大小,默认50,最大50条。
page
Integer
页码,默认值是1。

输出参数

参数名称
必选
参数类型
参数描述
total_count
Integer
分页查询返回数据总数。
current_size
Integer
分页查询返回单页数据条数。
current_page
Integer
分页查询返回当前页码。
total_page
Integer
分页查询返回分页总数。
meeting_record_id
String
会议录制 ID。
meeting_id
String
会议 ID。
meeting_code
String
会议 code。
subject
String
会议主题。
record_files
RecordFile 对象数组
直播录制文件列表。

RecordFile 对象

参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID。
view_address
String
播放地址。
download_address
String
下载地址,默认6小时过期。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
download_address_file_type
String
下载视频文件格式,例如:mp4。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address
String
音频下载地址。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address_file_type
String
下载音频文件格式,例如:m4a。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
meeting_summary
MeetingSummary 对象数组
录制转写文件列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

MeetingSummary 对象

参数名称
必选
参数类型
参数描述
download_address
String
下载文件地址。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docs。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
41
网络超时。
500
190001
存在未注册的用户。

示例

输入示例

GET https://api.meeting.qq.com/v1/addresses?meeting_record_id=1306538850111111111&userid=user_test

输出示例

{
"meeting_record_id":"1306538850111111111",
"meeting_id":"1360800131111111111",
"meeting_code":"423111111",
"subject":"user_test的快速会议",
"total_count":1,
"current_size":1,
"current_page":1,
"total_page":1,
"record_files":[
{
"record_file_id":"1318080811111111111",
"view_address":"https://yunluzhi-brucetest...",
"download_address":"https://yunluzhi-br...",
"download_address_file_type":"mp4",
"audio_address":"https://yunluzhi-brucetest...",
"audio_address_file_type":"m4a",
"meeting_summary":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
]
}
]
}