千问办公企业旗舰版开发者文档:更新个性化策略组。
- Scope:
admin.v1.personalization-policy-groups.manage - 接口: PATCH
/api/openapi/v1/personalization/policy-groups/{group_id}
公共请求头
适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。
请求参数
请求体:必填;Content-Type:application/json。
| 名称 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
group_id | path | string | 是 | 目标策略组 ID | - |
enabled | body | boolean | 否 | 是否启用 | - |
expected_revision | body | integer · int64 | null | 是 | 上次读取的组织管理版本 | - |
name | body | string | 否 | 显示名称 | - |
priority | body | integer · int64 | 否 | 匹配顺序,数值小的优先 | - |
scope | body | object | 否 | 策略生效人群 | - |
sections | body | object | 否 | 按名称区分的配置分区 | - |
body.scope 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
all_users | boolean | 是 | 匹配全体用户,开启后不再指定成员 |
department_ids | array<string> | null | 是 | 匹配的部门 ID |
user_group_ids | array<string> | null | 是 | 匹配的用户组 ID |
user_ids | array<string> | null | 是 | 匹配的用户 ID |
body.sections 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
credit-shortage | object | 否 | 积分不足提示和操作按钮 |
credit-usage | object | 否 | 积分用量展示方式和地址 |
homepage | object | 否 | 新任务首页欢迎语、推荐内容及显隐设置 |
input-placeholder | object | 否 | 正常输入和生成状态下的提示文案 |
navigation | object | 否 | 导航树、用户菜单及咨询入口 |
body.sections.credit-shortage 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
actionEnabled | boolean | 否 | 展示操作按钮 |
actionName | object | 否 | 积分操作按钮名称 |
actionURL | string | 否 | 积分操作跳转链接 |
description | object | 否 | 提示说明 |
enabled | boolean | 否 | 是否启用 |
title | object | 否 | 提示标题 |
body.sections.credit-shortage.actionName 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
body.sections.credit-shortage.description 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
body.sections.credit-shortage.title 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
body.sections.credit-usage 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
embeddedUrl | string | 否 | 内嵌用量页面地址 |
mode | string | 否 | 展示方式 取值:"default"、"embedded"、"redirect" |
redirectUrl | string | 否 | 外部用量页面地址 |
body.sections.homepage 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
recommendedPrompts | array<object> | 否 | 首页推荐语 |
visibility | object | 否 | 首页模块显隐开关 |
welcome | object | 否 | 首页欢迎语 |
body.sections.homepage.recommendedPrompts[] 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
category | string | 否 | 推荐语分类 |
createdAt | string | 否 | 推荐语创建时间 |
createdByEmail | string | 否 | 推荐语创建者邮箱 |
createdByName | string | 否 | 推荐语创建者名称 |
displayPrompt | string | 否 | 展示文案 |
enabled | boolean | 否 | 是否启用 |
id | string | 否 | 记录标识 |
inputPrompt | string | 否 | 实际填入输入框的文案 |
sourceRecordId | string | 否 | 推荐语来源记录 |
updatedAt | string | 否 | 推荐语更新时间 |
updatedByEmail | string | 否 | 推荐语修改者邮箱 |
updatedByName | string | 否 | 推荐语修改者名称 |
body.sections.homepage.visibility 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
featureSpotlights | object | 否 | 功能亮点入口 |
recommendedPrompts | object | 否 | 首页推荐语 |
body.sections.homepage.visibility.featureSpotlights 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.homepage.visibility.recommendedPrompts 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.homepage.welcome 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
withProject | object | 否 | 在项目内工作时的欢迎语 |
withoutProject | object | 否 | 无项目时的欢迎语 |
zh-CN | string | 否 | 简体中文文案 |
zh-TW | string | 否 | 繁体中文文案 |
body.sections.homepage.welcome.withProject 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
zh-TW | string | 否 | 繁体中文文案 |
body.sections.homepage.welcome.withoutProject 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
zh-TW | string | 否 | 繁体中文文案 |
body.sections.input-placeholder 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
generating | object | 否 | AI 回复中 |
normal | object | 否 | 正常输入状态 |
body.sections.input-placeholder.generating 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
body.sections.input-placeholder.normal 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
body.sections.navigation 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
consultation | object | 否 | 产品咨询与建议入口 |
nodes | array<object> | 否 | 导航节点列表 |
userMenu | object | 否 | 用户菜单项 |
body.sections.navigation.consultation 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
copy | object | 是 | 咨询入口文案 |
customUrl | string | 是 | 自定义咨询链接 |
enabled | boolean | 是 | 是否启用 |
mode | string | 是 | 展示方式 |
body.sections.navigation.consultation.copy 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
button | string | 是 | 按钮文案 |
buttonI18n | object | 否 | 各语言按钮文案 |
description | string | 是 | 提示说明 |
descriptionI18n | object | 否 | 各语言说明 |
tags | string | 是 | 咨询标签 |
tagsI18n | object | 否 | 各语言标签 |
title | string | 是 | 提示标题 |
titleI18n | object | 否 | 各语言标题 |
body.sections.navigation.nodes[] 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
custom | boolean | 否 | 是否自定义 |
enabled | boolean | 否 | 是否启用 |
icon | string | 否 | 图标名称 |
id | string | 否 | 记录标识 |
kind | string | 否 | 节点类型 |
locked | boolean | 否 | 内置锁定节点 |
name | string | 否 | 显示名称 |
nameI18n | object | 否 | 各语言显示名称 |
openMode | string | 否 | 链接打开方式 |
parentId | string | null | 否 | 父节点 ID,顶层为空 |
plugin | object | 否 | 节点的 Web 插件 |
url | string | 否 | 打开的链接 |
body.sections.navigation.nodes[].nameI18n 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
en | string | 否 | 英文文案 |
zh-CN | string | 否 | 简体中文文案 |
zh-TW | string | 否 | 繁体中文文案 |
body.sections.navigation.nodes[].plugin 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
envVars | string | 否 | 注入插件的环境变量 JSON |
route | string | 否 | 插件访问路由 |
source | string | 否 | 插件来源 |
version | string | 否 | 已发布的插件版本 |
web | object | 否 | 已发布插件的 Web 资源 |
webUploadId | string | 否 | 待发布插件包的上传会话 ID |
body.sections.navigation.nodes[].plugin.web 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
key | string | 否 | 同一组织内的插件包对象键 |
kind | string | 否 | 节点类型 |
sha256 | string | 否 | 插件包摘要 |
sizeBytes | integer | 否 | 已发布插件包的字节数 |
url | string | 否 | 打开的链接 |
body.sections.navigation.userMenu 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
fixed | object | 否 | 四个内置入口的可见性 |
items | array<object> | 否 | 可编辑的菜单项 |
body.sections.navigation.userMenu.fixed 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
balance | object | 否 | 积分余额入口 |
organization | object | 否 | 企业/团队入口 |
plan | object | 否 | 套餐入口 |
preferences | object | 否 | 偏好设置入口 |
body.sections.navigation.userMenu.fixed.balance 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.navigation.userMenu.fixed.organization 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.navigation.userMenu.fixed.plan 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.navigation.userMenu.fixed.preferences 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
visible | boolean | 否 | 是否展示 |
body.sections.navigation.userMenu.items[] 字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
custom | boolean | 否 | 是否自定义 |
icon | string | 是 | 图标名称 |
id | string | 是 | 记录标识 |
name | string | 是 | 显示名称 |
nameI18n | object | 否 | 各语言显示名称 |
openMode | string | 否 | 链接打开方式 |
url | string | 是 | 打开的链接 |
visible | boolean | 是 | 是否展示 |
请求示例
响应状态表
| HTTP 状态码 | 触发条件 | 响应结构引用 | 客户端处理建议 |
|---|---|---|---|
200 | 请求成功 | 见本文“响应结果” | 读取响应 |
429 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
503 | 限流或准入依赖不可用 | 见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构 | 按状态码及错误码处理 |
default | 其他认证、授权、版本冲突或校验错误 | 见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构 | 按状态码及错误码处理 |
响应结果
Content-Type: application/json
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
group_id | string | 是 | 目标策略组 ID | - |
revision | integer · int64 | 是 | 当前版本。列表和组详情顶层为组织管理版本,分区内为该分区的发布版本 | - |