有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

描述:当账户类型为企业版或教育版时,可查询企业预留虚拟会议室成员列表,支持根据用户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,依赖所购买资源的情况。

示例

输入示例

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
}
]
}