企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端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_tokenstring调用接口凭证。获取方法查看“获取access_token
meetingidstring会议 ID,不为空时优先根据会议 ID 查询。
meeting_codestring会议 code,当 meeting_id 为空且 meeting_code 不为空时根据会议 code 查询。当meeting_id 和meeting_code 均为空时,表示查询成员所有会议的录制列表。
useridstring待查询成员的userid。meetingid、meeting_code和userid三者选填其中一项。
start_timeint32查询起始时间戳,UNIX 时间戳(单位秒)。
说明:查询时间区间跨度不允许超过31天。
end_timeint32查询结束时间戳,UNIX 时间戳(单位秒)。
说明:查询时间区间跨度不允许超过31天。
cursorstring上一次调用时返回的next_cursor,初次调用可不传
limitint32单次查询返回的最大数量限制,默认为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
		}]
	}]
}

参数说明:

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

Record说明

参数类型说明
meeting_record_idstring会议录制 ID
meetingidstring会议 ID
meeting_codestring会议 code
host_user_idstring主持人userid
meeting_start_timeint64会议开始时间,UNIX 时间戳(单位毫秒)
titlestring会议主题。
stateint32录制状态:
1:录制中
3:转码完成
当状态为转码完成才会返回录制文件列表
record_file_listobject[]录制文件列表。详见RecordFile

RecordFile说明

参数类型说明
record_file_idstring录制文件 ID
record_start_timeint64开始录制时间,UNIX 时间戳(单位毫秒)。
record_end_timeint64结束录制时间,UNIX 时间戳(单位毫秒)。
record_sizeint32文件大小(单位字节)。
sharing_stateint32共享状态,是否开启共享。
0:未开启
1:开启
当开启共享时返回访问权限、访问密码、共享链接有效期、是否允许下载。
sharing_urlstring共享链接,开启共享时返回。
required_same_corpbool仅企业成员可查看,开启共享时返回。
required_attendeebool仅参会成员可查看,开启共享时返回。
passwordstring访问密码,开启共享时返回。
sharing_expireint64共享链接有效期(单位毫秒),当未开启共享时,返回0表示永久有效;开启共享时返回。
allow_downloadbool是否允许下载,开启共享时返回。
上一篇批量删除会议背景
下一篇获取录制文件访问统计
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们