获取账号资源统计

最近更新时间:2024-07-22 10:29:21

我的收藏

接口描述

描述:拥有用户查看权限的用户可以查看企业下各类型账号资源的统计数据。
鉴权方式:JWT 鉴权
自建应用权限点:企业用户查看
请求方式: GET
接口请求域名:
https://api.meeting.qq.com/v1/users/account/statistics


输入参数

参数名称
参数类型
是否必须
参数描述
operator_id
String
操作者 ID。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
操作者需要拥有企管用户查看权限。
operator_id_type
Integer
操作者 ID 的类型: 1:userid

输出参数

参数名称
参数类型
参数描述
user_count
Integer
当前用户数。
user_account_details
UserAccountDetails 对象数组
账号类型使用对象。
ai_account_details
AIAccountDetails 对象数组
AI 账号类型使用对象(商业版不返回)。

UserAccountDetails 对象

参数名称
参数类型
参数描述
user_account_type
Integer
账号类型: 1:高级账号 (企业版,教育版) 2:免费账号 (企业版,教育版,商业版) 3:免费账号100方 (商业版) 4:高级账号300方(商业版) 5:高级账号500方(商业版) 6:高级账号1000方(商业版) 7:高级账号2000方(商业版) 8:高级账号100方(商业版)
user_account_count
Integer
账号数。
user_account_used_count
Integer
已分配账号数。

AIAccountDetails 对象

参数名称
参数类型
参数描述
ai_account_type
Integer
AI 账号类型。
1:购买版
2:赠送版
ai_account_count
Integer
账号数。
ai_account_used_count
Integer
已分配账号数。

错误码列表

状态码
错误码
错误描述
400
190004
参数非法,请对照接口文档检查您的参数。
400
500053
用户信息查询失败。
400
500055
参数非法,请对照接口文档检查您的参数。
400
500054
AI 账号处理失败,该操作者没有权限。
400
500057
资源查询异常。

示例

输入示例

GET https://api.meeting.qq.com/v1/users/account/statistics?operator_id=user1&operator_id_type=1

输出示例

{
"user_count":100,
"user_account_details":[
{
"user_account_type":1,
"user_account_count":80,
"user_account_used_count":50
},
{
"user_account_type":2,
"user_account_count":50,
"user_account_used_count":50
}
],
"ai_account_details":[
{
"ai_account_type":1,
"ai_account_count":100,
"ai_account_used_count":50
}
]
}