sino-bc-cli 1.8.28 → 1.8.30

package/dist/api-doc/oapi/{biz-line-strategy.md → biz-line-metrics.md}

@@ -1,344 +1,18 @@
-# 业务线策略
+# 业务线策略广告成效数据
 
-对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
+对应命令：`biz-line-metrics +<shortcut>` 与 `biz-line-metrics api <name>`。
 
-## 1. 查询业务线分页列表
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 
-`POST /sino-opti-hive/biz-line/list`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
-
-**输入参数（--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-dict-items |
-| `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 | body | 否 | 周消耗环比筛选，DOWN_20 = 周消耗下降20%及以上 |
-
-## 2. 业务线详情
-
-`POST /sino-opti-hive/biz-line/detail`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-业务线详情
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 |  |
-
-## 3. 新建业务线
-
-`POST /sino-opti-hive/biz-line/save`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `name` | string | body | 是 | 业务线名称，业务/产品线名称不可重复 |
-| `mediaChannels` | array | body | 否 | 投放渠道 code。通过 GET /bc-business-pu/media/queryChannelInfo 取 channelId；名称见同接口 channelName |
-| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
-| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取一级节点 id |
-| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取二级 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`。
-
-角色范围：`sso`。
-
-更新业务线信息
-
-**输入参数（--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 /bc-business-pu/media/queryChannelInfo 取 channelId；名称见同接口 channelName |
-| `strategyControlDegree` | integer | body | 否 | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
-| `adCategoryIndustryIds` | array | body | 否 | 投放行业 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取一级节点 id |
-| `adCategoryProjectIds` | array | body | 否 | 投放品类 ID。通过 GET /sino-opti-hive/dict/items（sceneCode=PLACEMENT_CATEGORY） 取二级 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`。
-
-角色范围：`sso`。
-
-⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `id` | integer | body | 是 |  |
-| `status` | integer | body | 是 | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
-
-## 6. 查询投放策略分页列表
-
-`POST /sino-opti-hive/biz-line/strategy/list`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-查询投放策略分页列表
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `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达标且项目顺利。 |
-
-## 7. 查询投放策略消耗信息
-
-`POST /sino-opti-hive/biz-line/strategy/spend`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-查询投放策略消耗信息
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `strategyId` | integer | body | 是 | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
-
-## 8. 新建投放策略
-
-`POST /sino-opti-hive/biz-line/strategy/save`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-新建投放策略，投放策略按周填写
-
-**输入参数（--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 |
-
-## 9. 更新投放策略
-
-`POST /sino-opti-hive/biz-line/strategy/update`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-更新投放策略
-
-**输入参数（--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 |
-
-## 10. 查询业务线关联项目和广告账号
-
-`POST /sino-opti-hive/biz-line/project-list`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-根据业务线 ID 查询业务线关联项目和广告账号
-
-
-**输入参数（--data）**
-
-| 字段 | 类型 | 位置 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `bizLineId` | integer | body | 是 | 业务线 ID，必填 |
-
-## 11. 查询项目分页列表
-
-`POST /sino-opti-hive/optimize/project/queryByPage`
-
-主体上下文：`tenant=false`。
-
-角色范围：`sso`。
-
-查询项目分页列表
-
-**输入参数（--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 |
-
-## 12. Facebook广告策略维度数据
+## 1. Facebook广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。
 
@@ -395,13 +69,15 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 13. Google广告策略维度数据
+## 2. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等），用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度，出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Google广告策略成效数据」接口。
 
@@ -458,13 +134,15 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 14. TikTok广告策略维度数据
+## 3. TikTok广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。
 
@@ -521,13 +199,15 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 15. Facebook广告策略成效数据
+## 4. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
 
@@ -592,13 +272,15 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从 1 开始，默认 1。 |
 | `size` | integer | body | 否 | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 16. Google广告策略成效数据
+## 5. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。
 
@@ -663,13 +345,15 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | body | 否 | 页码，从1开始，默认1 |
 | `size` | integer | body | 否 | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 17. TikTok广告策略成效数据
+## 6. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。