获取会议录制列表 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 会议录制管理获取会议录制列表

获取会议录制列表

最后更新：2023/05/31

获取云录制记录，根据成员 ID、会议 ID、会议 code 进行查询，支持根据时间区间分页获取。如果使用成员ID进行查询，可以获取到该用户作为会议创建者的会议录制列表。

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/meeting/record/list?access_token=ACCESS_TOKEN

请求包体：

{
	"meetingid": "meetingid11234",
	"meeting_code": "MEETINGCODE",
	"start_time": 16666666,
	"end_time": 178888888,
	"userid": "USERID",
	"cursor":"NGEING",
	"limit":10
}

参数说明：

参数	必须	类型	说明
access_token	是	string	调用接口凭证。获取方法查看“获取access_token”
meetingid	否	string	会议 ID，不为空时优先根据会议 ID 查询。
meeting_code	否	string	会议 code，当 meeting_id 为空且 meeting_code 不为空时根据会议 code 查询。当meeting_id 和meeting_code 均为空时，表示查询成员所有会议的录制列表。
userid	否	string	待查询成员的userid。meetingid、meeting_code和userid三者选填其中一项。
start_time	是	int32	查询起始时间戳，UNIX 时间戳（单位秒）。说明：查询时间区间跨度不允许超过31天。
end_time	是	int32	查询结束时间戳，UNIX 时间戳（单位秒）。说明：查询时间区间跨度不允许超过31天。
cursor	否	string	上一次调用时返回的next_cursor，初次调用可不传
limit	否	int32	单次查询返回的最大数量限制，默认为10，最大20

注意：
limit参数必须与首次调用获得cursor时传入的limit一致。

权限说明

仅配置在“可调用接口的应用”列表中的自建应用可调用
仅允许获取该应用创建的会议的数据
仅返回在应用可见范围内的成员

返回结果：

{
	"errcode": 0,
	"errmsg": "ok",
	"record_meetings": [{
		"meeting_record_id": "GEIGN",
		"meetingid": "GEMIGE",
		"meeting_code": "GEJIGNEO",
		"host_user_id": "XGMEIG",
		"meeting_start_time": 177777777,
		"title": "TJIE",
		"state": 1,
		"record_files": [{
			"record_file_id": "FILEID",
			"record_start_time": 15555,
			"record_end_time": 1777777,
			"record_size": 323235325,
			"sharing_state": 1,
			"sharing_url": "https://share.url",
			"required_same_corp": true,
			"required_attendee": true,
			"password": "fgjisnge",
			"sharing_expire": 3323,
			"allow_download": true
		}]
	}]
}

参数说明：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
has_more	bool	是否还有未拉取的会议录制列表
next_cursor	string	当has_more=true时有值，表示当前数据最后一个key值，如果下次调用带上该值则从该key值往后拉，用于实现分页拉取。
record_list	object[]	会议录制列表，详见Record

Record说明

参数	类型	说明
meeting_record_id	string	会议录制 ID
meetingid	string	会议 ID
meeting_code	string	会议 code
host_user_id	string	主持人userid
meeting_start_time	int64	会议开始时间，UNIX 时间戳（单位毫秒）
title	string	会议主题。
state	int32	录制状态： 1：录制中 3：转码完成当状态为转码完成才会返回录制文件列表
record_file_list	object[]	录制文件列表。详见RecordFile

RecordFile说明

参数	类型	说明
record_file_id	string	录制文件 ID
record_start_time	int64	开始录制时间，UNIX 时间戳（单位毫秒）。
record_end_time	int64	结束录制时间，UNIX 时间戳（单位毫秒）。
record_size	int32	文件大小（单位字节）。
sharing_state	int32	共享状态，是否开启共享。 0：未开启 1：开启当开启共享时返回访问权限、访问密码、共享链接有效期、是否允许下载。
sharing_url	string	共享链接，开启共享时返回。
required_same_corp	bool	仅企业成员可查看，开启共享时返回。
required_attendee	bool	仅参会成员可查看，开启共享时返回。
password	string	访问密码，开启共享时返回。
sharing_expire	int64	共享链接有效期（单位毫秒），当未开启共享时，返回0表示永久有效；开启共享时返回。
allow_download	bool	是否允许下载，开启共享时返回。

批量删除会议背景

获取录制文件访问统计

本节内容

获取会议录制列表