Skip to main content
订阅产品支持可配置计费周期和多币种定价的周期性计费。产品可以组织到产品组中，实现共享试用管理和分层定价方案。

​
计费周期

​
产品组对象

产品组将相关的订阅产品组织在一起（如免费版、专业版、企业版），实现组内产品间的共享试用管理，并界定客户可以在哪些方案之间切换。每个组按环境存在 — 测试和生产各一行。
产品组 ID 使用 UUID 格式，而非 Short ID 格式。这是 API 中唯一使用原始 UUID 的实体。

​
规则

rules 的每个 key 都是一个独立开关，两者默认均为 false。
两个开关不显式打开就是关的 —— 已经存在的分组同样如此。 分组已存规则里缺失的 key 读出来就是 false，因此某个开关出现之前建的分组一律处于关闭状态。客户自助换方案不生效时，先查该分组的 selfServicePlanChange。
update-group 对 rules 是逐字段合并，不是整体替换。 传 rules: { selfServicePlanChange: true } 会让 sharedTrial 保持库中现值 —— 不需要把不改的开关一起重传。这与 productIds 恰好相反，后者是整列替换。无法识别的 key 会被丢弃而不落库，rules: null 与不传该字段等同。

​
端点

创建产品

创建带有计费周期和多币种定价的订阅产品。

更新产品

更新订阅产品内容。如有内容变更，创建新的不可变版本。

发布产品

将订阅产品从测试发布到生产（仅限首次发布）。

更新状态

激活或停用订阅产品。

创建产品组

创建产品组以组织相关订阅产品。

更新产品组

更新产品组的名称、描述、规则或产品列表。

删除产品组

永久删除产品组。

发布产品组

将产品组从测试发布到生产（支持重复 UPSERT）。