更新产品组的名称、描述、规则或商品列表。
POST /v1/actions/subscription-product-group/update-group
请求体
| 字段 | 类型 | 必需 | 说明 |
|---|
id | string | 是 | 产品组 ID（UUID 格式） |
name | string | 否 | 更新后的组名称 |
description | string | 否 | 更新后的描述 |
rules | object | 否 | 更新后的规则（{ sharedTrial: boolean }） |
productIds | string[] | 否 | 更新后的商品列表（PROD_xxx 格式）。替换整个列表。 |
请求示例
const { group } = await client.subscriptionProductGroups.update({
id: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
name: "Updated Pricing Plans",
productIds: [
"PROD_3F7H2J5L8N1Q4S6U",
"PROD_8B4D6F9H2K5M7P1R",
],
});
productIds 字段替换整个商品列表。要添加商品，请包含所有现有商品 ID 加上新的。要移除商品，从列表中省略即可。
错误响应
重试策略：4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试（起步 5s，最多 3 次）。
| 状态码 | errors[0].message | 含义 | 推荐处理 |
|---|
| 400 | Missing required field: id | 请求体缺少 id | 补齐 id 后重发 |
| 400 | Expected format: PROD_xxx, got "..." | productIds 中的 Short ID 无法解码 | 修正 ID 后重发 |
| 404 | Group not found | 指定 id 的产品组不存在 | 验证 id 是否属于你的门店 |
| 500 | Internal server error | 内部错误或瞬时下游故障 | 指数退避重试（起步 5s，最多 3 次） |
