sino-bc-cli 1.8.7 → 1.8.8

package/dist/SKILL.md

@@ -65,7 +65,7 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 Agent 先读子技能 `sino-bc-shared`，再按意图读域技能。
 
 1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/default/sino-bc-shared/SKILL.md`](skills/default/sino-bc-shared/SKILL.md)）
-2. 业务线、周策略、投放渠道/品类、关联项目、广告策略维度与成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
+2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
 3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
 
 安装与刷新（会写入上面列出的子技能到本机 `sino-bc-cli/`，并删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录）：

package/dist/affordance/biz-line.md

@@ -98,41 +98,41 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +queryByPage --data '{...}'`
 
-## +ad-list
+## +facebook-dimension
 
 - **WHEN**：Facebook广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +facebook-dimension --data '{...}'`
 
-## +google-ad-list
+## +google-dimension
 
 - **WHEN**：Google广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +google-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +google-dimension --data '{...}'`
 
-## +tiktok-ad-list
+## +tiktok-dimension
 
 - **WHEN**：TikTok广告策略维度数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +tiktok-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +tiktok-dimension --data '{...}'`
 
-## +facebook-ad-list
+## +facebook-metrics
 
 - **WHEN**：Facebook广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +facebook-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +facebook-metrics --data '{...}'`
 
-## +metrics-google-ad-list
+## +google-metrics
 
 - **WHEN**：Google广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +metrics-google-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +google-metrics --data '{...}'`
 
-## +metrics-tiktok-ad-list
+## +tiktok-metrics
 
 - **WHEN**：TikTok广告策略成效数据
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +metrics-tiktok-ad-list --data '{...}'`
+- **示例**：`sino-bc-cli biz-line +tiktok-metrics --data '{...}'`
 
 ## api
 

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

@@ -152,7 +152,34 @@ result 为公司分页对象：total=总条数，result=当前页 OptimizeProjec
 
 查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。
 
-国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+【国家维度特别说明】
+country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 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": [
+      "act_1036928420879324"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "order": "calendar_date",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -166,14 +193,15 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `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（广告名称）、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 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+| `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 为总条数，据此判断是否还有下一页。 |
 
 ## 16. Google广告策略维度数据
 
@@ -210,7 +238,34 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。
 
-国家维度特别说明：country_code 必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+【国家维度特别说明】
+country_code（国家）必须单独传入，不能和任何其他维度同时传，否则会报错「country_code 不能和其他维度同时传入」。查国家维度时服务端会转走跨渠道广告数据接口，只返回按国家分组的数据。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 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：
@@ -224,20 +279,53 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `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（广告名称）、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 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
-| `orderType` | string | 排序方向，默认 asc |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+| `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 为总条数，据此判断是否还有下一页。 |
 
 ## 18. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
-查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。数据最多支持近21天。
+查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
+
+【入参填写规则】
+1. startDate / endDate：字符串，格式 yyyy-MM-dd，两者都必填。
+2. dimensionValues：过滤条件，结构是「字段名 → 取值数组」的键值对（Java 类型 Map<String, List<Object>>）。每个 key 是字段 code，对应的 value 必须是数组，即使只筛一个值也要用数组包裹；同一个 key 内的多个值之间是「或」关系，命中任意一个即返回。本接口只有 account_id 这一个 key 生效，传入其他 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": [
+      "act_1036928420879324"
+    ]
+  },
+  "dimensions": [
+    "calendar_date",
+    "optimization_goal"
+  ],
+  "indicators": [
+    "spend_usd",
+    "impressions",
+    "clicks"
+  ],
+  "order": "spend_usd",
+  "orderType": "desc",
+  "page": 1,
+  "size": 20
+}
 
 【返回格式】
 result.data 为数据行数组，每行的每个字段有两个 key：
@@ -252,15 +340,16 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 
 | 字段 | 类型 | 说明 |
 | --- | --- | --- |
-| `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（广告名称）、objective（广告目标）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_interests（兴趣词包）、targeting_flexible_interests（弹性兴趣词包）、targeting_exclusion_interests（排除兴趣词包）、targeting_age（年龄）、targeting_genders（性别） |
-| `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 |
-| `page` | integer | 页码，从1开始，默认1 |
-| `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
+| `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 为总条数，据此判断是否还有下一页。 |
 
 ## 19. Google广告策略成效数据