腾讯会议获取账户级角色用户列表_办公协同解决方案
说明账户级接口属于仅账户管理员可以使用的接口，是重量级接口，查询的信息量比较大，访问限制：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 | 手机号。 |
| 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折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
