获取云录制记录,根据成员 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 | 是否允许下载,开启共享时返回。 |