腾讯会议获取账户级全量用户列表_办公协同解决方案
说明账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:100次/min。
接口描述
描述:获取账户中的所有用户列表,目前暂不支持 OAuth2.0 鉴权访问。请求方式:GET接口请求域名:
https://api.meeting.qq.com/v1/corp/users?page={page}&page_size={page_size}
输入参数
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/corp/users?page_size=20&page=1
输出示例
{ "total_count":1, "total_page":1, "current_page":1, "current_size":1, "users":[ { "userid":"testuser123", "uuid":"WMfgHRxxxxx6mcDGtK", "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折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案