腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 企业资源配置 > 查询企业预留虚拟会议室成员列表

查询企业预留虚拟会议室成员列表

最近更新时间：2024-04-23 16:12:04

我的收藏

本页目录：

接口描述

描述：当账户类型为企业版或教育版时，可查询企业预留虚拟会议室成员列表，支持根据用户ID或用户名搜索。不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/corp-resource/reserve-virtual-meeting-room/authorized-users?operator_userid={operator_userid}&page={page}&page_size={page_size}&userid={userid}&user_name={user_name}

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
operator_userid
是
String
操作者用户 ID，必须为企业下具有操作资源权限的注册用户。
userid
否
String
用户 ID，必须为企业下注册用户。
user_name
否
String
用户姓名，必须为企业下注册用户。
page
否
Integer
当前页，从1开始，默认为1。
page_size
否
Integer
分页大小，默认为20，不超过20。

输出参数

参数名称
参数类型
参数描述
current_page
Integer
当前页。
current_size
Integer
当前页实际大小。
total_count
Integer
数据总条数。
total_page
Integer
数据总页数。
meeting_room_info_list
MeetingRoomInfoList 对象数组
企业下虚拟会议室资源列表。
meeting_room_users
MeetingRoomUsers 对象数组
成员对象列表。
由于虚拟会议室资源的类型不同，可能会出现同一个企业成员 ID 对应多个虚拟会议室资源的情况。

MeetingRoomInfoList 对象

参数名称
参数类型
参数描述
meeting_room_total
Integer
企业已购买的虚拟会议室总数。
meeting_room_reserved
Integer
已为用户分配的虚拟会议室个数。
meeting_room_users_count
Integer
虚拟会议室已分配的用户数。
meeting_room_left
Integer
虚拟会议室剩余的个数。
resource_type
Integer
虚拟会议室资源类型。默认值为企业当前最小可分配资源类型，为保证资源分配准确，推荐填写虚拟会议室资源类型。
虚拟会议室资源类型有：50、100、300、500、1000、2000，依赖所购买资源的情况。

MeetingRoomUsers 对象数组

参数名称
参数类型
参数描述
userid
String
企业成员 ID。
user_name
String
成员名称。
meeting_room_count
Integer
预留的虚拟会议室个数。
meeting_room_status
Integer
虚拟会议室状态：
1. 可发起会议
2. 不可发起会议
resource_type
Integer
虚拟会议室资源类型。默认值为企业当前最小可分配资源类型，为保证资源分配准确，推荐填写虚拟会议室资源类型。
虚拟会议室资源类型有：50、100、300、500、1000、2000，依赖所购买资源的情况。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
500
20
查询相关资源异常，请稍后重试。
500
41
网络错误，请稍后重试。
500
403
没有资源操作权限。
500
190439
企业状态异常，场景：
1：企业非商业版与企业版
2：企业信息已过期或已被删除

示例

输入示例

GET
https://api.meeting.qq.com/v1/corp-resource/reserve-virtual-meeting-room/authorized-users?operator_userid=meeting452xxxx&page=1&page_size=20

输出示例

{
    "total_count": 3,
    "total_page": 1,
    "current_page": 1,
    "current_size": 3,
    "meeting_room_info_list": [
    {
      "meeting_room_total": 10,
      "meeting_room_reserved": 6,
      "meeting_room_users_count": 3,
      "resource_type": 300,
      "meeting_room_left": 4
    }
    ],
    "meeting_room_users": [
    {
      "userid": "meeting452xxxx",
      "user_name": "austin",
      "meeting_room_count": 1,
      "resource_type": 300,
      "meeting_room_status": 1
    }, 
    {
      "userid": "meeting452xxxx",
      "user_name": "tester1",
      "meeting_room_count": 2,
      "resource_type": 300,
      "meeting_room_status": 1
    }, 
    {
      "userid": "meeting452xxxx",
      "user_name": "tester-2",
      "meeting_room_count": 3,
      "resource_type": 300,
      "meeting_room_status": 1
    }
    ]
}

中国站