腾讯会议
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 录制管理 > 查询会议录制地址

查询会议录制地址

最近更新时间：2024-04-23 16:12:02

我的收藏

本页目录：

接口描述

描述：
查询会议录制地址，可获取会议云录制的播放地址和下载地址。
企业 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"
              }
             ]
        }
    ]
}

中国站