Skip to main content

查询用户命中的个性化策略组

千问办公企业旗舰版开发者文档:查询用户命中的个性化策略组。

  • 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_idquerystring是要验证的本组织用户 ID-

请求示例

curl --request GET \
  --url 'https://example.invalid/api/openapi/v1/personalization/policy-group-matches?user_id=11111111-1111-4111-8111-111111111111' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取响应
429限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
503限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
default其他认证、授权、版本冲突或校验错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态码及错误码处理

响应结果

Content-Type: application/json
名称类型必填说明示例
group_idstring是目标策略组 ID-
namestring是显示名称-
priorityinteger · int64是匹配顺序,数值小的优先-
revisioninteger · int64是当前版本。列表和组详情顶层为组织管理版本,分区内为该分区的发布版本-
scopeobject是策略生效人群-

scope

字段类型必填说明
all_usersboolean是匹配全体用户,开启后不再指定成员
department_idsarray<string> | null是匹配的部门 ID
user_group_idsarray<string> | null是匹配的用户组 ID
user_idsarray<string> | null是匹配的用户 ID

响应示例

{
  "revision": 1,
  "group_id": "11111111-1111-4111-8111-111111111111",
  "name": "Sales",
  "priority": 10,
  "scope": {
    "all_users": false,
    "user_ids": [
      "22222222-2222-4222-8222-222222222222"
    ],
    "department_ids": [],
    "user_group_ids": []
  }
}