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