文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯会议>开放平台文档>服务端 API>REST API 参考>账户管理>企业成员管理>获取账户级角色用户列表

获取账户级角色用户列表

最近更新时间：2025-12-30 11:42:01

我的收藏

本页目录：

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

接口描述

描述：获取账户中的被分配给某一个角色的所有用户列表，目前暂不支持 OAuth 2.0鉴权访问。
请求方式：GET
自建应用权限点：查看企业用户，管理企业用户。
接口操作者权限点：需具备用户角色的查看权限，可登录 管理后台 通过如下路径查看：用户管理 > 角色管理 > 查看权限。
接口请求域名：
https://api.meeting.qq.com/v1/corp/user-roles?page={page}&page_size={page_size}&role_code={role_code}&operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

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

查询参数

参数名称
必填
参数类型
参数描述
page_size
是
Integer
分页大小。
user_name
否
String
用户名称。
status
否
Integer
账号状态：
0：禁用
1：启用
2：未激活
role_code
否
String
角色类型。
operator_id
是
String
操作者 ID。
operator_id_type
是
Integer
操作者 ID 类型。
1：userid
pos
否
String
分页位置标记，默认值为""；
分页查询结果还有更多项时，会返回参数“next_pos”，可用其作为下一次查询的 pos 的值。
请多次调用该查询接口直到返回参数“has_remaining”值为 false。

输出参数

参数名称
参数类型
参数描述
users
用户对象列表。
has_remaining
Boolean
true：还有更多项，请继续调用此接口查询。
false：没有更多项。
next_pos
String
分页位置标记，当 has_remaining 为 true 时，会同时返回新的 next_pos，用以下一次查询的 pos 的值。

Users 对象

参数名称
参数类型
参数描述
userid
String
企业用户 userid。
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 对象

参数名称
参数类型
参数描述
department_id
String
部门 ID。
department_name
String
部门 name。
department_full_name
String
部门全称（包含全部上级部门名称，不包含公司名称）。
is_main
Boolean
是否主部门：
true：是
false：否

错误码列表

状态码
错误码
错误描述
400
190004
参数非法，请对照接口文档检查您的参数。
400
500014
账号无权限。

示例

输入示例

GET https://api.meeting.qq.com/v1/corp/user-roles?page_size=20&page=1&role_code=NORMAL_ROLE&operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1

输出示例

{
    "has_remaining":true,
    "next_pos":"WyIxNzQzNDk0NDkyliwid2VtZWV0aW5nNTA3Mzc3110=",
    "users":[
        {
            "userid":"testuser123",
            "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
                }
           ]
        }
    ]
}

中国站
目录