查询录制指定成员列表

最近更新时间:2025-08-20 15:00:51

我的收藏

接口描述

描述:获取录制文件的指定成员访问列表。
请求方式:GET
鉴权方式:AK/SK 鉴权、OAuth 2.0鉴权。
依赖权限点
自建应用:具备管理企业会议室详细信息权限。
三方应用:具备查看您的录制、查看和管理您的录制权限。
Operator 用户角色:勾选账户管理 > 录制管理 > 查看权限。可前往用户管理 > 角色管理页面设置。
接口请求域名
https://api.meeting.qq.com/v1/records/access/{meeting_record_id}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明

路径参数

参数名称
必选
参数类型
参数描述
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
}
]
}