接口描述
描述：拥有用户查看权限的用户可以查看企业下各类型账号资源的统计数据。
鉴权方式：AK/SK 鉴权
自建应用权限点：企业用户查看
请求方式：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 账号类型使用对象（商业版不返回）。 |
add_on_largemeeting_details | AddOnLargeMeetingDetails 对象数组 | 房间规模升级许可详情。 |
add_on_webinar_details | AddOnWebinarDetails 对象数组 | 网络研讨会（Webinar）观众规模升级许可详情。 |
UserAccountDetails 对象
参数名称 | 参数类型 | 参数描述 |
user_account_type | Integer | 指定账号类型。 1：高级账号（企业版/教育版） 2：免费账号（企业版/教育版） 3：免费账号100方 （商业版） 4：高级账号300方（商业版） 5：高级账号500方（商业版） 6：高级账号1000方（商业版） 7：高级账号2000方（商业版） 8：高级账号100方（商业版） 9：高级账号（企业版/教育版/商业版） 说明： 商业版2.0、企业版2.0、教育版2.0版本的账号，仅支持2和9两个账号类型。 |
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 | 已分配账号数。 |
AddOnLargeMeetingDetails 对象
参数名称 | 参数类型 | 参数描述 |
add_on_largemeeting_type | Integer | 房间规模升级许可类型 1：500方房间规模升级许可 2：1000方房间规模升级许可 3：2000方房间规模升级许可 |
add_on_largemeeting_count | Integer | 升级许可数。 |
add_on_largemeeting_used_count | Integer | 已分配升级许可数。 |
AddOnWebinarDetails 对象
参数名称 | 参数类型 | 参数描述 |
add_on_webinar_type | Integer | 增强会议体验：网络研讨会（Webinar）观众规模升级许可类型。 1：Webinar 观众规模提升至300观众 2：Webinar 观众规模提升至500观众 3：Webinar 观众规模提升至1000观众 4：Webinar 观众规模提升至2000观众 5：Webinar 观众规模提升至3000观众 6：Webinar 观众规模提升至5000观众 7：Webinar 观众规模提升至8000观众 8：Webinar 观众规模提升至10000观众 |
add_on_webinar_count | Integer | 升级许可数。 |
add_on_webinar_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}],"add_on_largemeeting_details":[{"add_on_largemeeting_type":1,"add_on_largemeeting_count":100,"add_on_largemeeting_used_count":50}],"add_on_webinar_details":[{"add_on_webinar_type":1,"add_on_webinar_count":100,"add_on_webinar_used_count":50}]}
