sino-bc-cli 1.8.9 → 1.8.11

package/dist/api-doc/oapi/biz-line-strategy.md

@@ -1,6 +1,6 @@
 # 业务线策略
 
-> **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连上游服务地址。
+> **网关地址**：缺省 `https://agent.beyondclick.com`，可用 `/set-config gateway-url` 改写；业务与登录共用该根。不要直连上游服务地址。
 >
 > **调用路径**：等于下方列出的 path（即 OpenAPI / catalog 路由），由 CLI 拼到网关地址后发出。
 
@@ -10,324 +10,383 @@
 
 `POST /sino-opti-hive/biz-line/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `pageNum` | integer | 页码，从 1 开始 |
-| `pageSize` | integer | 每页条数 |
-| `sortType` | string | 排序字段（继承 PageRequest.sortType）。SPEND=按上期周消耗；WEEK_OVER_WEEK=按上期周消耗环比；PERIOD=按本期策略周期；TRAFFIC_LIGHT=按上期红绿灯。不传时默认按业务线 id 倒序 |
-| `sortDirection` | string | 排序方向：ASC 升序，DESC 降序；默认 DESC |
-| `name` | string | 业务线名称，模糊搜索 |
-| `status` | integer | 状态：1=进行中 2=已完成 3=已暂停 |
-| `ssoTeamCode` | string | 组别 code，精确筛选（多选请用 ssoTeamCodeList） |
-| `ssoTeamCodeList` | array | 组别 code 列表，多选 |
-| `trafficLightList` | array | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
-| `adCategoryProjectId` | integer | 投放品类：取接口biz-line-open-placement-categories |
-| `idList` | array | 业务线 ID 列表 |
-| `pmUserIds` | array | PM 用户 ID 多选（OR 语义：命中任一 PM） |
-| `projectRatingList` | array | 项目评级多选：S、A、B、C |
-| `businessRegionList` | array | 商务地区：EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北 |
-| `newCustomerTag` | string | 新客标签单选，NEW_TAG = 新客   NONE_NEW_TAG = 非新客
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 是 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 是 | 每页条数 |
+| `sortType` | string | body | 否 | 排序字段（继承 PageRequest.sortType）。SPEND=按上期周消耗；WEEK_OVER_WEEK=按上期周消耗环比；PERIOD=按本期策略周期；TRAFFIC_LIGHT=按上期红绿灯。不传时默认按业务线 id 倒序 |
+| `sortDirection` | string | body | 否 | 排序方向：ASC 升序，DESC 降序；默认 DESC |
+| `name` | string | body | 否 | 业务线名称，模糊搜索 |
+| `status` | integer | body | 否 | 状态：1=进行中 2=已完成 3=已暂停 |
+| `ssoTeamCode` | string | body | 否 | 组别 code，精确筛选（多选请用 ssoTeamCodeList） |
+| `ssoTeamCodeList` | array | body | 否 | 组别 code 列表，多选 |
+| `trafficLightList` | array | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
+| `adCategoryProjectId` | integer | body | 否 | 投放品类：取接口biz-line-open-placement-categories |
+| `idList` | array | body | 否 | 业务线 ID 列表 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID 多选（OR 语义：命中任一 PM） |
+| `projectRatingList` | array | body | 否 | 项目评级多选：S、A、B、C |
+| `businessRegionList` | array | body | 否 | 商务地区：EAST_CHINA=华东 SOUTH_CHINA=华南 NORTH_CHINA=华北 |
+| `newCustomerTag` | string | body | 否 | 新客标签单选，NEW_TAG = 新客   NONE_NEW_TAG = 非新客
  |
-| `weekOverWeekFilter` | string | 周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上 |
+| `weekOverWeekFilter` | string | body | 否 | 周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上 |
 
 ## 2. 业务线详情
 
 `POST /sino-opti-hive/biz-line/detail`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 业务线详情
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer |  |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 |  |
 
 ## 3. 新建业务线
 
 `POST /sino-opti-hive/biz-line/save`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 ⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `name` | string | 业务线名称，业务/产品线名称不可重复 |
-| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
-| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
-| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
-| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
-| `adCategoryOther` | string | 投放品类-其他说明 |
-| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
-| `customerTypeOther` | string | 客户类型-其他说明 |
-| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
-| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
-| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
-| `coreIndex` | string | 核心指标 |
-| `monthlyMaterialCount` | string | 月度上新素材量 |
-| `projectInitStatus` | string | 项目初始化状态 |
-| `projectBrief` | string | 项目 Brief |
-| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
-| `projectIds` | array | 关联项目 ID |
-| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
-| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
-| `projectRating` | string | S、A、B、C。非新客必填 |
-| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | string | body | 是 | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | body | 否 | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | body | 否 | 投放品类-其他说明 |
+| `customerTypeIds` | array | body | 否 | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | body | 否 | 客户类型-其他说明 |
+| `amUserIds` | array | body | 否 | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | body | 否 | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | body | 否 | 核心指标 |
+| `monthlyMaterialCount` | string | body | 否 | 月度上新素材量 |
+| `projectInitStatus` | string | body | 否 | 项目初始化状态 |
+| `projectBrief` | string | body | 否 | 项目 Brief |
+| `corporationIds` | array | body | 否 | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | body | 否 | 关联项目 ID |
+| `ssoTeamCode` | string | body | 是 | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | body | 是 | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | body | 否 | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | body | 否 | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
 
 ## 4. 更新业务线
 
 `POST /sino-opti-hive/biz-line/update`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 更新业务线信息
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
-| `status` | integer | 状态：1进行中 2已完成 3已暂停 |
-| `name` | string | 业务线名称，业务/产品线名称不可重复 |
-| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
-| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
-| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
-| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
-| `adCategoryOther` | string | 投放品类-其他说明 |
-| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
-| `customerTypeOther` | string | 客户类型-其他说明 |
-| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
-| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
-| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
-| `coreIndex` | string | 核心指标 |
-| `monthlyMaterialCount` | string | 月度上新素材量 |
-| `projectInitStatus` | string | 项目初始化状态 |
-| `projectBrief` | string | 项目 Brief |
-| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
-| `projectIds` | array | 关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds |
-| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
-| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
-| `projectRating` | string | S、A、B、C。非新客必填 |
-| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停 |
+| `name` | string | body | 是 | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | body | 否 | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | body | 否 | 投放品类-其他说明 |
+| `customerTypeIds` | array | body | 否 | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | body | 否 | 客户类型-其他说明 |
+| `amUserIds` | array | body | 否 | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | body | 否 | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | body | 否 | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | body | 否 | 核心指标 |
+| `monthlyMaterialCount` | string | body | 否 | 月度上新素材量 |
+| `projectInitStatus` | string | body | 否 | 项目初始化状态 |
+| `projectBrief` | string | body | 否 | 项目 Brief |
+| `corporationIds` | array | body | 否 | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | body | 否 | 关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds |
+| `ssoTeamCode` | string | body | 是 | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | body | 是 | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | body | 否 | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | body | 否 | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
 
 ## 5. 更新业务线状态
 
 `POST /sino-opti-hive/biz-line/status/update`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 ⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer |  |
-| `status` | integer | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 |  |
+| `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
 
 ## 6. 删除业务线
 
 `POST /sino-opti-hive/biz-line/del`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 ⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer |  |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 |  |
 
 ## 7. 查询投放策略分页列表
 
 `POST /sino-opti-hive/biz-line/strategy/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询投放策略分页列表
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `pageNum` | integer | 页码，从 1 开始 |
-| `pageSize` | integer | 每页条数 |
-| `sortDirection` | string | 创建日期排序 DESC 或 ASC，默认 DESC |
-| `bizLineId` | integer | 可选，不传则按权限查全部可见业务线。 |
-| `trafficLight` | integer | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 是 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 是 | 每页条数 |
+| `sortDirection` | string | body | 否 | 创建日期排序 DESC 或 ASC，默认 DESC |
+| `bizLineId` | integer | body | 否 | 可选，不传则按权限查全部可见业务线。 |
+| `trafficLight` | integer | body | 否 | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
 ## 8. 查询投放策略消耗信息
 
 `POST /sino-opti-hive/biz-line/strategy/spend`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询投放策略消耗信息
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `strategyId` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `strategyId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
 ## 9. 新建投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/save`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 新建投放策略，投放策略按周填写
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
-| `periodStart` | string | 策略周期起（日期） |
-| `periodEnd` | string | 策略周期止（日期） |
-| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
-| `budgetStrategySupplement` | string | 预算策略补充说明 |
-| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
-| `mediaStrategySupplement` | string | 媒介策略补充说明 |
-| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
-| `audienceStrategySupplement` | string | 受众策略补充说明 |
-| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
-| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
-| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
-| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
-| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
-| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
-| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
-| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
-| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
-| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
-| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
-| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
-| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
-| `spend` | string | 周期投放消耗（回顾，展示用字符串），最大 50 字 |
-| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
-| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
-| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
-| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
-| `budgetStrategyLearning` | string | 预算策略 learning |
-| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
-| `mediaStrategyLearning` | string | 媒介策略 learning |
-| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
-| `audienceStrategyLearning` | string | 受众策略 learning |
-| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
-| `creativeStrategyLearning` | string | 素材策略 learning |
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizLineId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `periodStart` | string | body | 是 | 策略周期起（日期） |
+| `periodEnd` | string | body | 是 | 策略周期止（日期） |
+| `budgetStrategyTags` | array | body | 是 | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | body | 是 | 预算策略补充说明 |
+| `mediaStrategyTags` | array | body | 是 | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | body | 是 | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | body | 是 | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | body | 是 | 受众策略补充说明 |
+| `creativeStrategy` | string | body | 是 | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | body | 否 | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | body | 否 | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | body | 否 | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | body | 否 | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | body | 否 | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | body | 否 | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | body | 否 | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | body | 否 | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | body | 否 | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | body | 否 | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | body | 否 | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | body | 否 | 项目问题&机会，最大 5000 字 |
+| `spend` | string | body | 否 | 周期投放消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | body | 否 | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | body | 否 | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | body | 否 | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | body | 否 | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | body | 否 | 预算策略 learning |
+| `mediaStrategyEffect` | integer | body | 否 | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | body | 否 | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | body | 否 | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | body | 否 | 受众策略 learning |
+| `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
 ## 10. 更新投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/update`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 更新投放策略
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
-| `version` | integer | 乐观锁版本号 |
-| `overwrite` | boolean | 默认 false：版本冲突则报错；true 强制覆盖 |
-| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
-| `periodStart` | string | 策略周期起（日期） |
-| `periodEnd` | string | 策略周期止（日期） |
-| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
-| `budgetStrategySupplement` | string | 预算策略补充说明 |
-| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
-| `mediaStrategySupplement` | string | 媒介策略补充说明 |
-| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
-| `audienceStrategySupplement` | string | 受众策略补充说明 |
-| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
-| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
-| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
-| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
-| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
-| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
-| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
-| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
-| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
-| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
-| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
-| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
-| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
-| `spend` | string | 周期消耗（回顾，展示用字符串），最大 50 字 |
-| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
-| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
-| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
-| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
-| `budgetStrategyLearning` | string | 预算策略 learning |
-| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
-| `mediaStrategyLearning` | string | 媒介策略 learning |
-| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
-| `audienceStrategyLearning` | string | 受众策略 learning |
-| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
-| `creativeStrategyLearning` | string | 素材策略 learning |
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| `version` | integer | body | 是 | 乐观锁版本号 |
+| `overwrite` | boolean | body | 否 | 默认 false：版本冲突则报错；true 强制覆盖 |
+| `bizLineId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/list 取 id |
+| `periodStart` | string | body | 是 | 策略周期起（日期） |
+| `periodEnd` | string | body | 是 | 策略周期止（日期） |
+| `budgetStrategyTags` | array | body | 是 | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | body | 是 | 预算策略补充说明 |
+| `mediaStrategyTags` | array | body | 是 | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | body | 是 | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | body | 是 | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | body | 是 | 受众策略补充说明 |
+| `creativeStrategy` | string | body | 是 | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | body | 否 | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | body | 否 | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | body | 否 | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | body | 否 | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | body | 否 | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | body | 否 | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | body | 否 | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | body | 否 | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | body | 否 | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | body | 否 | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | body | 否 | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | body | 否 | 项目问题&机会，最大 5000 字 |
+| `spend` | string | body | 否 | 周期消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | body | 否 | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | body | 否 | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | body | 否 | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | body | 否 | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | body | 否 | 预算策略 learning |
+| `mediaStrategyEffect` | integer | body | 否 | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | body | 否 | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | body | 否 | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | body | 否 | 受众策略 learning |
+| `creativeStrategyEffect` | integer | body | 否 | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | body | 否 | 素材策略 learning |
 
 ## 11. 删除投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/del`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 删除投放策略
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
 ## 12. 查询业务线关联项目和广告账号
 
 `POST /sino-opti-hive/biz-line/project-list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 根据业务线 ID 查询业务线关联项目和广告账号
 
 
-**请求体**
+**输入参数（--data）**
 
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `bizLineId` | integer | 业务线 ID，必填 |
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
 
 ## 13. 查询项目分页列表
 
 `POST /sino-opti-hive/optimize/project/queryByPage`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询项目分页列表
 
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `pageNum` | integer | 页码，从 1 开始 |
-| `pageSize` | integer | 每页条数 |
-| `sortType` | string | lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime |
-| `sortDirection` | string | ASC 升序，DESC 降序；默认 DESC |
-| `corporationId` | integer | 签约主体 ID |
-| `corporationIdList` | array | 签约主体 ID 多选 |
-| `projectId` | integer | 项目 ID，精确匹配 |
-| `projectIdList` | array | 项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填 |
-| `projectName` | string | 项目名称，模糊查询 |
-| `projectKeyword` | string | 项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND） |
-| `startDate` | string | 项目周期开始日期 yyyy-MM-dd |
-| `endDate` | string | 项目周期结束日期 yyyy-MM-dd |
-| `projectUserIdList` | array | 项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
-| `ssoTeamCodeList` | array | 组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
-| `adAccountId` | string | 广告账号 ID 模糊查询，至少 2 个字符 |
-| `demandOrderKeyword` | string | 需求单编号精确，或需求单名称分词模糊（空格分词） |
-| `signalLightList` | array | 项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举） |
-| `projectStatusList` | array | 项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名 |
-| `isLast7DSpend` | array | 0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛 |
-| `uploadInfoTypeList` | array | 0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选 |
-| `serviceCodeList` | array | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
-| `bizLineIdList` | array | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `sortType` | string | body | 否 | lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime |
+| `sortDirection` | string | body | 否 | ASC 升序，DESC 降序；默认 DESC |
+| `corporationId` | integer | body | 否 | 签约主体 ID |
+| `corporationIdList` | array | body | 否 | 签约主体 ID 多选 |
+| `projectId` | integer | body | 否 | 项目 ID，精确匹配 |
+| `projectIdList` | array | body | 否 | 项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填 |
+| `projectName` | string | body | 否 | 项目名称，模糊查询 |
+| `projectKeyword` | string | body | 否 | 项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND） |
+| `startDate` | string | body | 否 | 项目周期开始日期 yyyy-MM-dd |
+| `endDate` | string | body | 否 | 项目周期结束日期 yyyy-MM-dd |
+| `projectUserIdList` | array | body | 否 | 项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `ssoTeamCodeList` | array | body | 否 | 组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `adAccountId` | string | body | 否 | 广告账号 ID 模糊查询，至少 2 个字符 |
+| `demandOrderKeyword` | string | body | 否 | 需求单编号精确，或需求单名称分词模糊（空格分词） |
+| `signalLightList` | array | body | 否 | 项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举） |
+| `projectStatusList` | array | body | 否 | 项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名 |
+| `isLast7DSpend` | array | body | 否 | 0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛 |
+| `uploadInfoTypeList` | array | body | 否 | 0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选 |
+| `serviceCodeList` | array | body | 否 | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
+| `bizLineIdList` | array | body | 否 | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 id |
 
 ## 14. Facebook广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。
 
 【国家维度特别说明】
-country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，由此有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
 
 【入参填写规则】
 1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
-2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
 3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
 4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"calendar_date":"desc","account_id":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
 5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
@@ -357,29 +416,62 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 "-"。
 result.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。
 result.total 为总条数，result.page 和 result.size 为当前分页。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
-| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
-| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
-| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、country_code（国家，必须单独传，不能和其他维度同时传） |
-| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
-| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从 1 开始，默认 1。 |
-| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | body | 是 | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `order` | string | body | 否 | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | body | 否 | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
+| `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
 ## 15. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等），用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度，出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Google广告策略成效数据」接口。
 
-国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+【国家维度特别说明】
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，由此有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"calendar_date":"desc","account_id":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "<广告账户ID，格式同 account_id 维度返回值>"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "order": "calendar_date",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -387,34 +479,40 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 "-"。
 result.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。
 result.total 为总条数，result.page 和 result.size 为当前分页。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字）、country_code（国家，必须单独传，不能和其他维度同时传） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
+| `endDate` | string | body | 是 | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `order` | string | body | 否 | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
+| `orderType` | string | body | 否 | 排序方向，默认 asc |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从1开始，默认1 |
+| `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
 ## 16. TikTok广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。
 
 【国家维度特别说明】
-country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，由此有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
 
 【入参填写规则】
 1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
-2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
 3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
 4. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"calendar_date":"desc","account_id":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
 5. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
@@ -444,31 +542,40 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 二是展示值，key 加 display_ 前缀，直接呈现给用户时用这个，空值为 "-"。
 result.headerMap 是字段 code 到中文列名的映射，用于给用户展示列名。
 result.total 为总条数，result.page 和 result.size 为当前分页。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
-| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
-| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
-| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）、country_code（国家，必须单独传，不能和其他维度同时传） |
-| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
-| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从 1 开始，默认 1。 |
-| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | body | 是 | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、bid_amount（调整出价）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `order` | string | body | 否 | 单字段排序的字段名，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | body | 否 | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
+| `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
 ## 17. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
 
+【国家维度特别说明】
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，indicators 里的 12 个指标在该接口同样支持、照常返回聚合值，但有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
+
 【入参填写规则】
 1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
-2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 key 不会报错，但也不会产生任何过滤效果。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
 3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
 4. indicators：成效指标数组，必填。指标会在 dimensions 指定的分组粒度上做求和聚合。
 5. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"spend_usd":"desc","clicks":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
@@ -505,28 +612,69 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 result.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。
 result.total 为总条数，result.page 和 result.size 为当前分页。
 result.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
-| `endDate` | string | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。 |
-| `dimensionValues` | object | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口只有 account_id 一个 key 生效，传其他 key 不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
-| `dimensions` | array | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别） |
-| `indicators` | array | 成效指标，字符串数组，必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
-| `order` | string | 单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
-| `orderType` | string | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从 1 开始，默认 1。 |
-| `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 统计开始日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-01"。必填。 |
+| `endDate` | string | body | 是 | 统计结束日期，字符串，格式 yyyy-MM-dd，例如 "2026-08-31"。必填，需大于等于 startDate。成效数据最多支持查询近21天，超出范围可能返回空数据。 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，字符串数组，必传且不能为空数组（传空数组返回结果为空）。传多个维度时按多字段组合分组，等同 SQL 的 GROUP BY 多列，维度越多粒度越细、返回行数越多。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `indicators` | array | body | 是 | 成效指标，字符串数组，必传且不能为空数组。指标会在 dimensions 指定的分组粒度上做求和聚合。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
+| `order` | string | body | 否 | 单字段排序的字段名，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回。与 orders 可同时使用，order 指定的字段会追加到 orders 之后。 |
+| `orderType` | string | body | 否 | 排序方向，配合 order 使用。desc 降序，asc 升序，默认 asc。 |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
+| `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
 ## 18. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
-查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。数据最多支持近21天。
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。
+
+【国家维度特别说明】
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，indicators 里的 12 个指标在该接口同样支持、照常返回聚合值，但有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. indicators：成效指标数组，必填。指标会在 dimensions 指定的分组粒度上做求和聚合。
+5. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"spend_usd":"desc","clicks":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+6. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "<广告账户ID，格式同 account_id 维度返回值>"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "indicators": [
+    "spend_usd",
+    "impressions",
+    "clicks"
+  ],
+  "order": "spend_usd",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -535,28 +683,69 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 result.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。
 result.total 为总条数，result.page 和 result.size 为当前分页。
 result.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字） |
-| `indicators` | array | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
+| `endDate` | string | body | 是 | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `indicators` | array | body | 是 | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
+| `order` | string | body | 否 | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
+| `orderType` | string | body | 否 | 排序方向，默认 asc |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从1开始，默认1 |
+| `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
 ## 19. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 
-查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
+
+【国家维度特别说明】
+country_code（国家）只能单独传，或与 calendar_date（投放日期）两个一起传；与其他任何维度同传都会报错「[country_code]只能和[calendar_date]同时传入」。
+传入 country_code 时服务端转走跨渠道广告数据接口取数，indicators 里的 12 个指标在该接口同样支持、照常返回聚合值，但有两点差异：
+一是 dimensionValues 里额外支持 country_code 作为过滤条件，传国家码数组即可按国家筛选；不传 country_code 维度时该过滤条件无效。
+二是 headerMap 的列名来自跨渠道接口，calendar_date 列名为「日期」而不是「投放日期」，country_code 列名为「国家/地区」；展示列名请以 headerMap 实际返回值为准，不要写死。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口默认只有 account_id 这一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件。传入其余 key 不会报错，但也不会产生任何过滤效果。
+3. dimensions：分组维度数组，必填。传多个维度时按多个字段组合分组，效果等同 SQL 的 GROUP BY 多列，维度越多返回行数越多、粒度越细。
+4. indicators：成效指标数组，必填。指标会在 dimensions 指定的分组粒度上做求和聚合。
+5. 排序：单字段排序用 order（字段名）+ orderType（desc / asc）；多字段排序用 orders，结构是「字段名 → 排序方向」的有序键值对，按书写顺序依次排序，例如 {"spend_usd":"desc","clicks":"asc"}。两者可同时使用，order 指定的字段会追加到 orders 之后。
+6. 分页：page 从 1 开始（默认 1），size 为每页条数（默认 10）。返回的 result.total 是总条数，据此判断是否还有下一页。
+
+【请求示例】
+{
+  "startDate": "2026-08-01",
+  "endDate": "2026-08-31",
+  "dimensionValues": {
+    "account_id": [
+      "<广告账户ID，格式同 account_id 维度返回值>"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "indicators": [
+    "spend_usd",
+    "impressions",
+    "clicks"
+  ],
+  "order": "spend_usd",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -565,19 +754,18 @@ result.data 为数据行数组，每行的每个字段有两个 key：
 result.headerMap 是字段 code 到列名的映射，维度列名为中文，指标列名为英文（如 spend_usd 对应 Spend）。
 result.total 为总条数，result.page 和 result.size 为当前分页。
 result.conflictField 是传入但当前渠道不支持的指标，会被忽略且不报错，为空数组表示全部指标都生效。
-外层 code 为 0 表示成功；非 0 时 result 为 null，失败原因在 message 字段里。
-
-**请求体**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `startDate` | string | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
-| `endDate` | string | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天 |
-| `dimensionValues` | object | 过滤条件，仅支持 account_id 一个 key，传其他 key 会报错 |
-| `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、objective（广告目标）、targeting_interests（兴趣词包）、conversion_bid（转化出价）、deep_cpabid（深度转化出价） |
-| `indicators` | array | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
-| `order` | string | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `startDate` | string | body | 是 | 开始日期，格式 yyyy-MM-dd，例如 2026-08-01 |
+| `endDate` | string | body | 是 | 结束日期，格式 yyyy-MM-dd，例如 2026-08-31。最多支持查询近21天 |
+| `dimensionValues` | object | body | 是 | 过滤条件。结构为「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>），value 必须是数组，即使只筛一个值也要用数组包裹。本接口默认只有 account_id 一个 key 生效；当 dimensions 里传了 country_code 时，额外支持 country_code 作为过滤条件（国家码数组）。其余 key 传入不报错但无过滤效果。示例：{"account_id": ["act_123", "act_456"]} |
+| `dimensions` | array | body | 是 | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、objective（广告目标）、targeting_interests（兴趣词包）、conversion_bid（转化出价）、deep_cpabid（深度转化出价）、country_code（国家，只能单独传或与 calendar_date 两个一起传） |
+| `indicators` | array | body | 是 | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
+| `order` | string | body | 否 | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
+| `orderType` | string | body | 否 | 排序方向，默认 asc |
+| `orders` | object | body | 否 | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
+| `page` | integer | body | 否 | 页码，从1开始，默认1 |
+| `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |