腾讯会议查询会议录制列表_办公协同解决方案
接口描述
描述：获取用户云录制记录，根据用户 ID、会议 ID、会议 code 进行查询，支持根据时间区间分页获取。企业 secret 鉴权用户可获取该用户所属企业下的会议录制列表，OAuth2.0 鉴权用户只能获取该企业下 OAuth2.0 应用的会议录制列表。当您想实时监测会议录制相关状况时，您可以通过订阅 录制管理 中的相关事件，接收事件通知。当前同一场会议的不同录制文件共用分享链接。请求方法：GET接口请求域名：
https://api.meeting.qq.com/v1/records?page_size={page_size}&page={page}&meeting_id={meeting_id}&meeting_code={meeting_code}&userid={userid}&start_time={start_time}&end_time={end_time}
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| 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，仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用。当会议 ID 和会议 code 均为空时，表示查询用户所有会议的录制列表（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。企业唯一用户标识说明：1：企业对接 SSO 时使用的员工唯一标识 ID。2：企业调用创建用户接口时传递的 userid 参数。 |
| meeting_id | 否 | String | 会议 ID，不为空时优先根据会议 ID 查询。 |
| meeting_code | 否 | String | 会议 code，当 meeting_id 为空且 meeting_code 不为空时根据会议 code 查询。 |
| start_time | 是 | Integer | 查询起始时间戳，UNIX 时间戳（单位秒）。说明：时间区间不允许超过31天。 |
| end_time | 是 | Integer | 查询结束时间戳，UNIX 时间戳（单位秒）。说明：时间区间不允许超过31天。 |
| page_size | 否 | Integer | 分页大小，默认值为10，最大为20。 |
| page | 否 | Integer | 页码，从1开始，默认值为1。 |
| media_set_type | 否 | Number | 会议类型：0：全部1：公网会议2：专网会议 |
输出参数
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| total_count | 是 | Integer | 分页查询返回数据总数。 |
| current_size | 是 | Integer | 分页查询返回单页数据条数。 |
| current_page | 是 | Integer | 分页查询返回当前页码。 |
| total_page | 是 | Integer | 分页查询返回分页总数。 |
| record_meetings | 否 | RecordMeeting 对象 | 会议录制列表。 |
RecordMeeting 对象
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| meeting_record_id | 是 | String | 会议录制 ID。 |
| meeting_id | 是 | String | 会议 ID。 |
| meeting_code | 是 | String | 会议 code。 |
| media_set_type | 否 | Number | 会议类型：1：公网会议2：专网会议 |
| host_user_id | 是 | String | 会议创建者 ID。 |
| media_start_time | 是 | Integer | 会议开始时间，UNIX 时间戳（单位毫秒）。 |
| subject | 是 | String | 会议主题。 |
| state | 是 | Integer | 录制状态：1：录制中2：转码中3：转码完成当状态为转码完成才会返回录制文件列表。 |
| record_files | 否 | RecordFile 对象数组 | 录制文件列表。 |
RecordFile 对象
| 参数名称 | 必选 | 参数类型 | 参数描述 |
| 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表示永久有效；开启共享时返回。 |
| allow_download | 否 | Bool | 是否允许下载，开启共享时返回。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/records?meeting_code=423111111&userid=testUser&start_time=1602950400&end_time=1603123200
输出示例
{ "total_count":1, "current_size":10, "current_page":1, "total_page":1, "record_meetings":[ { "meeting_record_id":"1318080818611111111", "meeting_id":"1360800130111111111", "meeting_code":"423111111", "host_user_id":"testUser", "media_start_time":1603089930093, "subject":"testUser的快速会议", "state":3, "record_files":[ { "record_file_id":1318080818611111111, "record_start_time":1603089930577, "record_end_time":1603089967213, "record_size":604081, "sharing_state":1, "required_same_corp":false, "required_participant":false, "password":"cK3wAsfw", "sharing_expire":0, "allow_download":false } ] } ]}
对腾讯办公协同的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
