Skip to main content

列出个性化策略组

千问办公企业旗舰版开发者文档:列出个性化策略组。

  • Scope: admin.v1.personalization-policy-groups.read
  • 接口: GET/api/openapi/v1/personalization/policy-groups
获取组织策略管理版本和按优先级排列的组元数据(默认组在首位)。列表不包含配置分区。

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

无请求参数。

请求示例

curl --request GET \
  --url 'https://example.invalid/api/openapi/v1/personalization/policy-groups' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

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

响应结果

Content-Type: application/json
名称类型必填说明示例
can_manageboolean是应用是否拥有策略组管理权限-
groupsarray<object> | null是当前组织的策略组-
revisioninteger · int64是当前版本。列表和组详情顶层为组织管理版本,分区内为该分区的发布版本-

groups[]

字段类型必填说明
created_atstring · date-time | null是记录创建时间
created_bystring | null是创建者 ID
enabledboolean是是否启用
idstring是记录标识
is_defaultboolean是标识不可删除的默认组
namestring是显示名称
priorityinteger · int64是匹配顺序,数值小的优先
scopeobject是策略生效人群
updated_atstring · date-time | null是最近修改时间
updated_bystring | null是修改者 ID

groups[].scope

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

响应示例

{
  "can_manage": true,
  "revision": 1,
  "groups": [
    {
      "id": "08d8e3ec-400c-50bc-9a4e-352ab322c421",
      "name": "默认策略组",
      "is_default": true,
      "enabled": true,
      "priority": 9999,
      "scope": {
        "all_users": true,
        "user_ids": [],
        "department_ids": [],
        "user_group_ids": []
      },
      "created_by": null,
      "created_at": null,
      "updated_by": null,
      "updated_at": null
    },
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Sales",
      "is_default": false,
      "enabled": true,
      "priority": 10,
      "scope": {
        "all_users": false,
        "user_ids": [
          "22222222-2222-4222-8222-222222222222"
        ],
        "department_ids": [],
        "user_group_ids": []
      },
      "created_by": "22222222-2222-4222-8222-222222222222",
      "created_at": "2026-11-03T08:00:00Z",
      "updated_by": "22222222-2222-4222-8222-222222222222",
      "updated_at": "2026-11-03T08:00:00Z"
    }
  ]
}