来源中的信息
发生了什么
Shopify 将每条 Events 订阅查询的复杂度上限从 250 点降至 100 点;复杂度依所选字段、字段返回的数据类型,以及连接请求的项目数计算。
该限制按单条订阅查询计算;Events 订阅执行的查询不计入应用 API 速率限制。
此次调整不影响 Classic Webhooks。
经营影响
为什么重要
如果应用现有订阅查询超过 100 点,超限风险在于单条查询本身;不能以 Events 查询不计入 API 速率限制,推断复杂度限制也不适用。
对经营依赖商品、变体或库存变更同步的商家,影响取决于其应用是否使用 Events,以及应用方的订阅查询能否适配新上限。
编辑观察
分析判断
这不是面向所有 Shopify 店铺的通用 Webhook 变更,而是针对 Events 订阅查询的限制调整;未使用 Events 或仅使用 Classic Webhooks 的商家,不应把此上限套用到自己的流程。
拆分查询可能有助于把每条查询控制在上限内,但应用方仍需确认拆分后处理程序需要的字段与关联数据没有遗漏。
适用范围
对卖家的影响
若商家使用的第三方应用通过 Events 订阅同步商品或变体变更,应向应用商确认其查询是否超过 100 点及是否需要调整;输入未说明具体生效日期或各应用的适配状态。
行动建议
现在应该做什么
- 1
确认应用是否使用 Events 订阅
本周向应用商或内部开发人员确认变更通知使用的是 Events 还是 Classic Webhooks;此次复杂度上限调整仅适用于前者。
- 2
核查超限查询与数据覆盖
本周如有自建 Events 集成,请检查每条订阅查询是否超过 100 点。可评估按处理工作拆分同一主题的订阅,或直接查询发生变更的资源,并确认处理程序所需字段仍然齐全。
暂时不要做什么
- 不要仅因这项更新就更改 Classic Webhooks;来源明确说明它们不受此次调整影响。
- 不要把 Events 查询不计入应用 API 速率限制,误解为查询不受 100 点复杂度上限约束。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读;链接与流程校验不等于独立事实核验。内部置信值是工作流信号,不代表事实正确的概率。
- 01来源链接
We’re reducing the query complexity limit for Events subscriptions from 250 to 100 points. This change does not affect Classic Webhooks. Shopify assigns each Events query a complexity score based on the fields it selects, the types of data those fields return, and the number of items requested in connections using first or last, following the GraphQL query cost calculation. The limit applies to each subscription query, and queries executed by Events subscriptions don’t count toward your app’s API rate limits. What to do Review subscription queries that exceed 100 points and shape each subscription around the changes your app handles: Split subscriptions by the work they do: You can configure multiple subscriptions for the same topic, each with its own triggers and query. Query the changed resource directly: For example, for a variant price change, query the affected variant’s price, SKU, and parent Product ID instead of fetching the Product’s first 250 variants. This avoids repeatedly fetching unchanged variants and covers changed variants beyond the first page. Match queries to available variables: A variant price trigger provides $variantsId, but a product title trigger doesn’t.
Shopify Developer Changelog · 核对状态: 单一来源
获取时间: 2026年9月22日 18:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.
相关教程与工具
这页对你有用?转发出去
复制链接、扫码或通过系统分享,把这页内容转发给同事、朋友或合作方。