来源中的信息
发生了什么
Shopify Admin GraphQL API 现可通过 rollouts 查询列出、搜索 Rollouts，并通过 rollout(id:) 按 ID 获取单个 Rollout。
应用可以读取 Rollout 对折扣、目录、主题以及结账和账户配置的影响、计划启用与结束时间、配置流量分配、当前有效流量分配和 treatment split 值。
配置的流量分配不单独决定实际触达范围；平台同时提供生命周期、有效流量分配和资源变更的 Rollout Webhook，应用收到通知后应重新获取受影响的 Rollout。
访问 Rollout 数据需要 read_rollouts；底层资源载荷仍适用现有资源权限，部分既有安装可能需要商家重新授权。
经营影响
为什么重要
平台协调发布、实验或临时事件时，应用不必只依赖商家看到的最终页面变化，而可以获得更接近配置状态和变更通知的信号。
这会把折扣、目录、主题和结账配置的兼容性检查，从一次性的版本适配问题，转化为持续同步和状态判断问题。
对商家而言，真正需要确认的不是应用是否宣称支持 Rollouts，而是它能否在权限、通知和重新读取状态都成立时保持业务逻辑一致。
编辑观察
分析判断
Rollout 查询与 Webhook 共同形成了“读取状态—接收变化—重新确认”的同步机制；由于配置分配与有效触达可能不同，应用若只读取一次配置就执行逻辑，可能无法准确判断某项变化当前影响了哪些对象。证据仅确认了可读取的字段和通知类型，未说明平台如何计算有效触达或通知时序，因此商家应把这视为需要验证的集成边界，而不是一致性保证。
对使用折扣、目录、主题或结账相关应用的全球市场商家，平台变化的直接后果主要落在应用兼容性与授权维护上，而不是商家店铺自动获得某种新销售能力；如果既有安装需要重新授权，相关应用可能暂时无法读取 Rollout 数据。证据没有提供失败率、覆盖范围或经营结果，所以商家决策应聚焦于受影响应用的权限和更新状态，不应据此预估转化或收入变化。
下一步应采用“先盘点依赖，再按风险验证”的规则：凡是会根据折扣、目录、主题或结账配置作出自动决策的应用，优先确认其是否支持 read_rollouts、Rollout Webhook 和变更后的重新读取；仅当应用方明确说明这些能力已覆盖时，才把 Rollout 状态纳入自动化流程。当前证据来自单一官方变更记录，未提供 API 参考中的完整字段约束或迁移示例，因此不宜直接假设所有现有应用都已兼容。
适用范围
对卖家的影响
全球市场中，使用第三方折扣、目录、主题或结账应用的商家需要关注应用是否能处理 Rollout 带来的临时或分阶段配置变化。
既有应用安装可能涉及重新授权；在应用方完成确认前，商家不应假设其能读取新的 Rollout 数据。
没有相关自动化应用，或应用不读取这些配置的商家，当前更适合观察供应商兼容性，而不是立即调整店铺运营流程。
行动建议
现在应该做什么
- 1
盘点受影响的应用依赖
this-week列出会读取或改变折扣、目录、主题、结账和账户配置的应用，并向应用供应商确认是否已支持 Rollouts、read_rollouts 和相关 Webhook。
- 2
核对授权与状态同步方案
this-week对既有安装确认是否需要商家重新授权，并要求供应商说明收到 Rollout 变更后是否会重新读取受影响资源。
- 3
观察有效分配与通知表现
monitor在应用方确认支持后，检查其展示或记录的有效流量分配、生命周期和资源变更是否能与实际业务配置对应；不要只依据配置分配判断触达范围。
暂时不要做什么
- 不要把配置的流量分配直接当作实际触达比例，也不要在没有供应商兼容性确认的情况下自行改写折扣、目录、主题或结账自动化逻辑。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
Summary Apps can now discover Rollouts, inspect their schedules, traffic allocation, and resource changes, and receive notifications when they change. These capabilities help apps understand and respond to coordinated launches, experiments, and temporary events across discounts, catalogs, themes, and checkout and accounts configurations. What's new Discover and read Rollouts. Use the root rollouts query to list and search Rollouts, and rollout(id:) to fetch a Rollout directly by ID. See what a Rollout changes. Read how each treatment affects discounts, catalogs, themes, and checkout and accounts configurations. Understand schedules and allocation. Read planned activation and conclusion times, configured trafficAllocation, current effectiveTrafficAllocation, and treatment split values. Configured allocation alone does not determine effective reach. Stay up to date. Subscribe to Rollout webhooks for lifecycle, effective-allocation, and resource-change notifications. Refetch affected Rollouts to keep your integration current. Access Rollout data Request read_rollouts to access Rollout data. Existing resource scopes apply to the underlying resource payloads, and existing installations
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年10月1日 16:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.