接口描述
描述:获取录制文件的指定成员访问列表。
请求方式:GET
鉴权方式:AK/SK 鉴权、OAuth 2.0鉴权。
依赖权限点:
自建应用:具备管理企业会议室详细信息权限。
三方应用:具备查看您的录制、查看和管理您的录制权限。
Operator 用户角色:勾选账户管理 > 录制管理 > 查看权限。可前往用户管理 > 角色管理页面设置。
接口请求域名:
https://api.meeting.qq.com/v1/records/access/{meeting_record_id}
输入参数
路径参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_record_id | 是 | String | 会议录制 ID。 |
查询参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id_type | 是 | Integer | 操作人 ID 类型: 1:userid 2:open_id |
operator_id | 是 | String | 操作人 ID。 |
cursor | 否 | Integer | 分页获取成员数据的起始位置值。当查询返回输出参数“has_more”为 true,表示该会议人数较多,还有一定数量的参会成员需继续查询。返回参数“next_cursor”的值为下一次查询的 cursor 的值。多次调用该查询接口直到输出参数“has_more”值为 false。 说明:初始值为“0”。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
total_count | Integer | 总人数。 |
has_more | Boolean | 是否还有未获取的数据。 true:是 false:否 |
next_cursor | Integer | 下一页的游标和“has_more”一起,数据量比较大的情况下支持参会成员列表的多次获取,传参给cursor。 |
access_members | 访问成员列表。 |
AccessMembers 对象
参数名称 | 参数类型 | 参数描述 |
userid | String | 参会者用户 ID。 使用企业自建应用鉴权方式(AK/SK)时,该值为企业唯一用户标识。 |
open_id | String | 已授权用户的 ID。 使用第三方应用鉴权方式(OAuth 2.0)时,该值为已授权用户的 open_id。 |
ms_open_id | String | 当场会议的用户临时 ID,可用于会控操作,适用于所有用户。 |
permission | Integer | 成员访问权限,默认为0: 0:仅查看 1:可管理 |
示例
输入示例
GET https://api.meeting.qq.com/v1/records/access/131823201111?operator_id_type=1&operator_id=wemeeting600545536
输出示例
{"total_count":20,"has_more":true,"next_cursor":3,"access_members": [{"userid":"wemeeting6004665536","open_id":"3545453","ms_open_id":"79545824997","permission":1},{"userid":"wemeeting600535536","open_id":"353553","ms_open_id":"793564997","permission":0},{"userid":"wemeeting600765536","open_id":"3245553","ms_open_id":"798576997","permission":1}]}