更新您的应用以适配折扣 Rollouts
摘要
Admin GraphQL API 版本 2026-10 在折扣类型之间添加了只读的 rollouts 连接。读取折扣的应用程序应使用 Discount.rollouts 以及现有的折扣字段，以考虑由 Rollout 驱动的计划和买家覆盖范围。
变更内容
商家可以在 Rollouts 中包含折扣，以协调发布、向部分买家测试折扣，或与其他店铺变更同步运行临时活动。当折扣属于某个 Rollout 时，其原生日期并不能完整描述其可用性。
更新您的集成
- 请求访问权限。 将 read_rollouts 添加到您应用的权限范围中。现有的资源权限范围仍然适用于底层资源有效载荷，且现有安装可能需要商家重新授权。
- 读取折扣的 Rollouts。 查询 Discount.rollouts 以确定哪些 Rollout 会影响该折扣。
- 结合计划与可用性数据。 将 Rollout 计划字段与折扣现有的 startsAt 和 endsAt 字段一起读取。同时读取有效分配、处理拆分，以及每项更改是激活还是使折扣过期。仅配置的流量分配并不能决定有效覆盖范围。
考虑销售渠道的可用性
在 100% 有效流量下激活的折扣可在所有销售渠道中使用，但需符合正常的折扣适用规则。部分流量 Rollout 激活仅适用于在线商店。
不在 Rollouts 中的折扣行为与之前相同。
早期 API 版本
在早于 2026-10 版本的 Admin GraphQL API 中，如果折扣处于活动状态但可能无法触达所有买家，或其状态与从原生日期推断出的状态不同，则会被过滤掉。
请参阅《Discount Rollouts 升级指南》以获取集成指导和示例。
若要独立于折扣发现 Rollout，或在它们发生变化时接收通知，请参阅《Admin GraphQL API 中的 Rollout 查询和网络钩子》。