ProductVariant 现已成为 Publishable。在 API 版本 2026-07 中，变体可以按发布渠道（频道或目录）设置为已发布或未发布状态，使商家及其应用能够在不删除变体、复制产品或通过 storefront 代码隐藏变体的情况下，对每个变体的可见位置进行细粒度控制。
这是一个非破坏性、增量式的变更：
- 产品级别的发布行为保持不变，且仍具有优先权。只有当产品处于激活状态并已发布到某个渠道时，其变体才能在该渠道中显示。
- 变体默认处于已发布状态（采用退出机制）。现有在产品级别进行发布的应用无需修改即可继续正常工作。
- 可以创建未发布的变体，以防止过早向买家展示。
管理后台 GraphQL API 的新增功能
- publishablePublish 和 publishableUnpublish 现在接受 ProductVariant ID。
- ProductVariant 现在遵循 Publishable 接口，类似于 Product 和 Collection，其中包括 resourcePublicationv2 和 publishedOnPublication。
- 当变体发布到产品提要的渠道时，产品提要网络钩子会在添加或删除变体时触发产品更新事件。
- variant_publication/create/update/delete 变体 _publication /create /update /delete 网络钩子仍在开发中，即将上线。
这对您的应用意味着什么
- 使用产品提要的渠道应用通常无需任何更改即可正常工作——产品提要将变体添加到产品中并从中移除，同时会触发增量同步网络钩子。
- 不使用产品 feed 且依赖通过管理 GraphQL API 读取发布状态的频道或伪频道，应通过 ProductVariant.resourcePublicationsv2 读取变体的相应发布状态来实现支持。
- 在产品发布后创建变体的应用：新变体默认在其父产品的所有发布中处于已发布状态。如果您的应用计划以未发布状态创建变体，productSet 和 productVariantBulkCreate 均包含一个 variant.published: false 字段，用于将变体创建为未发布状态。
- 发布产品的应用：无需更改。继续像以前一样对调用 publishablePublish。如果您的应用工作流涉及取消发布变体，建议实现变体发布支持。
阅读开发者指南 →