文档中心>腾讯会议>开放平台文档>服务端 API>REST APIs>录制管理>查询单个录制详情(文件、转写、纪要)

查询单个录制详情(文件、转写、纪要)

最近更新时间:2024-05-14 14:18:51

我的收藏

接口描述

描述:查询单个云录制的详情信息,包括录制文件和录制转写,并可获取播放地址和下载地址。企业 secret 鉴权用户可获取该用户所属企业下的单个录制列表,OAuth2.0 鉴权用户只能获取该企业下 OAuth2.0 应用的单个录制列表。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/addresses/{record_file_id}?userid={userid}

输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID,列表接口返回的 record_file_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 参数。

输出参数

参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID。
meeting_id
String
会议 ID。
meeting_code
String
会议 code。
view_address
String
播放地址。
download_address
String
录制文件下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
download_address_file_type
String
下载视频文件格式,例如:mp4。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address
String
音频下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
audio_address_file_type
String
下载音频文件格式,例如:m4a。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
meeting_summary
MeetingSummary 对象数组
录制转写文件列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
ai_meeting_transcripts
MeetingTranscripts 对象数组
录制转写文件(智能优化版)列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
ai_minutes
Minutes 对象数组
智能纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

MeetingSummary 对象

参数名称
必选
参数类型
参数描述
download_address
String
录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

MeetingTranscripts 对象

参数名称
必选
参数类型
参数描述
download_address
String
录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

Minutes 对象

参数名称
必选
参数类型
参数描述
download_address
String
智能纪要文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。
file_type
String
下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
9042
无权限进行该操作,建议检查操作者身份或资源归属。
400
500014
账号无权限。
500
190001
存在未注册的用户。
500
960000
网络错误,请稍后重试。
500
190310
每分钟总接口调用次数超过限制。
500
4051
录制文件已经被删除。
500
4049
查询单条记录失败,不存在的记录。
500
41
网络超时。
500
403
没有资源操作权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/addresses/1318080811111111111?userid=user_test


输出示例

{
"meeting_id":"1318080811111111111",
"meeting_code":"423411111",
"record_file_id":"1318080811111111111",
"view_address":"https://yunluzhi-brucetest...",
"download_address":"https://yunluzhi-brucetest...",
"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"
}
],
"ai_meeting_transcripts":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
],
"ai_minutes":[
{
"download_address":"https://yunluzhi-brucetest...",
"file_type":"txt"
}
]
}