来源中的信息
发生了什么
在 API 版本 2026-10 中，Shopify Functions 的 cart.deliveryGroups.deliveryOptions 可通过 metafield(namespace:, key:) 读取配送选项上的 metafield。
该能力适用于构建 Delivery Customization Functions，以及输入包含配送选项的其他 Functions；未查询这一字段的应用不会改变现有行为。
配送选项 metafield 可返回 value、type 和 jsonValue，但 数据不会在结账后持久化，而是由配送选项生成函数或承运商服务响应在当前结账流程中附加。
读取权限仍遵循现有 metafield 所有权规则：应用可读取自身保留命名空间和未加前缀的共享命名空间；其他应用保留的命名空间会返回 null。旧版 Order Discounts 和 Product Discounts API 的 cart.deliveryGroups 始终为空。
经营影响
为什么重要
对使用配送选项生成与后续配送定制函数的商家或应用团队，这提供了在函数之间传递结构化配送数据的标准入口。
由于数据仅属于当前结账流程，商家不能把该字段当作订单完成后的持久化记录或售后数据源。
编辑观察
分析判断
这更像是 Functions 数据传递能力的补齐，而不是面向所有 Shopify 商家的前台配送体验更新；只有采用相关配送函数架构的应用才可能获得直接收益。
如果现有实现依赖配送选项标题或 handle 携带内部信息，metafield 能减少对展示文本或标识符解析的依赖，但仍需在生成函数和下游读取函数之间约定命名空间与 key。
版本和命名空间是主要边界：升级到 2026-10 并不会自动让其他应用保留的命名空间可读，也不会改变旧版折扣 API 中配送选项数据为空的限制。
适用范围
对卖家的影响
普通使用 Shopify 原生配送配置、没有相关 Functions 应用的商家，短期内没有可见运营变化。
使用配送选项生成、承运商服务或 Delivery Customization Functions 的商家，可以评估是否将当前结账流程中的配送规则数据改为通过 metafield 传递。
依赖结账后复用配送选项数据的流程不会因该更新获得持久化能力，订单、分析或售后系统仍需使用已有数据来源。
行动建议
现在应该做什么
- 1
盘点是否使用相关配送 Functions
this-week检查应用或定制开发是否包含配送选项生成、承运商服务响应或 Delivery Customization Function；若没有这些组件，无需为本次更新改动商店配置。
- 2
为适用应用核对 API 版本与命名空间
this-week对确实需要读取配送选项数据的应用，确认目标 API 版本为 2026-10，并明确自身保留命名空间或共享命名空间及对应 key；不要假设其他应用保留的命名空间可读。
- 3
验证数据是否只用于当前结账流程
monitor在任何实施前确认业务逻辑不会依赖结账后的配送选项 metafield；需要持久化的数据应继续由现有订单或业务系统记录。
暂时不要做什么
- 不要为了本次更新对所有商店或所有 Functions 统一迁移，也不要把配送选项 metafield 当作结账后的持久化订单字段。
- 不要尝试读取其他应用保留的命名空间并据此设计关键配送逻辑，因为该访问会返回 null。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
Shopify Functions can now read metafields attached to delivery options in the cart. On API version 2026-10, you can call metafield(namespace:, key:) on any option in cart.deliveryGroups.deliveryOptions. This affects apps that build Delivery Customization Functions and any other function whose input includes delivery options. No action is required. What changed In the Functions cart graph, CartDeliveryOption now includes a metafield field: metafield(namespace: String, key: String!): Metafield The returned Metafield exposes value, type, and jsonValue. Metafields on a delivery option are not persisted after checkout. A delivery option generator function or shipping carrier service response attaches them when it generates the option, and they exist only for that checkout. Access follows the existing metafield ownership rules. A function can read metafields in its own app‑reserved namespace and in any unprefixed shared namespace. A namespace reserved by a different app resolves to null. A Delivery Customization input query can now read both app-reserved and shared metafields on delivery options. For example: { cart { deliveryGroups { deliveryOptions { handle ownNamespace: metafield(name
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年9月15日 14:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.