腾讯会议查询企业预留虚拟会议室成员列表-开放平台文档-文档中心-腾讯云

接口描述
描述：当账户类型为企业版或教育版时，可查询企业预留虚拟会议室成员列表，支持根据用户 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。
search_types
否
String
查询维度，以逗号分隔指定。
1：用户维度
2：部门维度
例如：想要获取部门列表和用户列表，则传入“1,2”。默认只返回用户列表。
输出参数
参数名称
参数类型
参数描述
current_page
Integer
当前页。
current_size
Integer
当前页实际大小。
total_count
Integer
数据总条数。
total_page
Integer
数据总页数。
meeting_room_info_list
MeetingRoomInfoList 对象数组
企业下虚拟会议室资源列表。
meeting_room_users
MeetingRoomUsers 对象数组
成员对象列表。
由于虚拟会议室资源的类型不同，可能会出现同一个企业成员 ID 对应多个虚拟会议室资源的情况。
meeting_room_departments
MeetingRoomDepartments 对象数组
部门对象列表。
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，依赖所购买资源的情况。
MeetingRoomDepartments 对象数组
参数名称
参数类型
参数描述
department_id
String
企业成员 ID。
department_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
    }
    ]
}
﻿

参数名称	必选	参数类型	参数描述
operator_userid	是	String	操作者用户 ID，必须为企业下具有操作资源权限的注册用户。
userid	否	String	用户 ID，必须为企业下注册用户。
user_name	否	String	用户姓名，必须为企业下注册用户。
page	否	Integer	当前页，从1开始，默认为1。
page_size	否	Integer	分页大小，默认为20，不超过20。
search_types	否	String	查询维度，以逗号分隔指定。 1：用户维度 2：部门维度例如：想要获取部门列表和用户列表，则传入“1,2”。默认只返回用户列表。

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

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

本页目录：

接口描述

输入参数

输出参数

MeetingRoomInfoList 对象

MeetingRoomUsers 对象数组

MeetingRoomDepartments 对象数组

错误码列表

示例

输入示例

输出示例