千问办公企业旗舰版开发者文档:查询用户命中的个性化策略组。
- Scope:
admin.v1.personalization-policy-groups.read - 接口: GET
/api/openapi/v1/personalization/policy-group-matches
admin.v1.user-directory.read 才能按用户查询;仅授予策略组读取权限时返回 403。
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
user_id | query | string | 是 | 要验证的本组织用户 ID | - |
请求示例
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
200 | 请求成功 | 见本文“响应结果” | 读取响应 |
429 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
503 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
default | 其他认证、授权、版本冲突或校验错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态码及错误码处理 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
group_id | string | 是 | 目标策略组 ID | - |
name | string | 是 | 显示名称 | - |
priority | integer · int64 | 是 | 匹配顺序,数值小的优先 | - |
revision | integer · int64 | 是 | 当前版本。列表和组详情顶层为组织管理版本,分区内为该分区的发布版本 | - |
scope | object | 是 | 策略生效人群 | - |
scope
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
all_users | boolean | 是 | 匹配全体用户,开启后不再指定成员 |
department_ids | array<string> | null | 是 | 匹配的部门 ID |
user_group_ids | array<string> | null | 是 | 匹配的用户组 ID |
user_ids | array<string> | null | 是 | 匹配的用户 ID |