腾讯会议获取账户级角色用户列表_办公协同解决方案

说明账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:10次/min。

接口描述

描述:获取账户中的被分配给某一个角色的所有用户列表,目前暂不支持 OAuth2.0 鉴权访问。请求方式:GET接口请求域名:

https://api.meeting.qq.com/v1/corp/users?page={page}&page_size={page_size}&role_code={role_code}

输入参数

HTTP 请求头公共参数参考签名验证章节里的 公共参数说明。

参数名称 必选 参数类型 参数描述
page_size Integer 分页大小。
page Integer 当前页。
user_name String 用户名称。
userid String 用户 userid。
uuid String 用户身份 ID(腾讯会议颁发的用于开放平台的唯一用户 ID)。
status Integer 账号状态:0:禁用1:启用2:未激活
role_code String 角色类型。

输出参数

参数名称 参数类型 参数描述
current_page Integer 当前页。
current_size Integer 当前页实际大小。
total_count Integer 数据总条数。
total_page Integer 数据总页数。
users Users 对象数组 用户对象列表。

Users 对象

参数名称 参数类型 参数描述
userid String 企业用户 userid。
uuid String 用户身份 ID(腾讯会议颁发的用于开放平台的唯一用户 ID)。
user_name String 企业用户 name。
area String 手机区号。
update_time String 更新时间。
avatar_url String 用户图像地址。
role_name String 角色名称。
role_code String 角色类型。
phone String 手机号。
email String 邮箱。
status Integer 账号状态。
departments Departments 对象数组 部门对象列表。

Departments 对象

参数名称 参数类型 参数描述
id String 部门 ID。
name String 部门 name。
full_name String 部门全称(包含全部上级部门名称,不包含公司名称)。
is_main boolean 是否主部门:true:是 false:否

示例

输入示例

GET /v1/users/list?page_size=20&page=1&role_code=NORMAL_ROLE

输出示例

{    "total_count":1,    "total_page":1,    "current_page":1,    "current_size":1,    "users":[        {            "userid":"testuser123",            "uuid":"WMfgHRYj6m36mcDGtK",            "user_name":"test123",            "area":"86",            "update_time":"2020-09-02 07:29:39",            "role_name":"超级管理员",            "role_code":"ADMIN_ROLE",            "phone":"12365475648",            "status":1,            "departments":[                {                    "id":"123",                    "name":"质量组",                    "full_name":"质量部/质量组",                    "is_main":true                }           ]        }    ]}



对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案