Metafield GraphQL 对象的新可翻译布尔字段

API版本2026-10在GraphQL管理API的Metafield对象中添加了非空的translatable字段。获取可翻译元字段并迁移到2026-10的应用现在可以直接在元字段本身上查看其值是否可翻译。如果您的应用不按商店查询可翻译元字段，则无需进行任何更改。

变更内容

GraphQL管理API中的Metafield对象在API版本2026-10中公开了一个新的非空字段translatable: Boolean!：

{ product(id: "gid://shopify/Product/1") { metafield(namespace: "custom", key: "care_guide") { type # "single_line_text_field" translatable # true } } }

translatable 返回平台在决定元字段值是否可翻译时已强制执行的结果。

在此更改之前，应用必须使用translatableResources上的已弃用枚举TranslatableResourceType.METAFIELD来查询可翻译元字段。在API版本2026-10及更高版本中，您应该读取Metafield对象上的translatable，而不是通过translatableResources查询元字段。

受影响对象

适用于以下应用：

• 在版本2026-10或更高版本上调用GraphQL管理API，并且
• 获取可翻译的元字段

版本2026-07及更早版本的应用不受影响。translatable在这些版本中不可用，而TranslatableResourceType.METAFIELD作为已弃用的内容继续存在。

无论版本如何，读取元字段值时不考虑可翻译性的应用均不受影响。

此更改未引入功能预览和新的访问范围。可用性仅取决于API版本，因此一旦将请求移至2026-10，该字段就会显示。

为何重要

应用需要停止使用translatableResources上的TranslatableResourceType.METAFIELD枚举来获取可翻译元字段。

在此变更之前，判断元字段是否可翻译需要维护一份可翻译元字段类型的列表。应用还必须保持该逻辑与平台同步。

translatable 将上述规则合并为一个布尔值。由于该字段基于平台自身的谓词进行解析，而非应用内复制的规则副本，因此当可翻译性规则发生变化时，它仍能保持正确。

操作指南

如果您的应用不按商店查找可翻译元字段，则在迁移到2026-10时无需进行任何更改。

如果确实如此，那么在迁移到2026-10时：

1. 检查您是否在顶级resourceType参数中使用TranslatableResourceType.METAFIELD调用了translatableResources。
2. 更新这些查询以直接读取Metafield对象上的translatable字段，而不是通过translatableResources对元字段进行分类。
3. 在开发商店中使用 API 版本 2026-10 测试您的更改，并确认：以前传递 Translatable Resource Type.METAFIELD 的查询不再在您的应用中运行，并且您的 UI 使用 metafield.translatable 值来决定何时提供翻译。 2026-10 并确认：
   • 以前传递TranslatableResourceType.METAFIELD的查询不再在您的应用中运行，并且
   • 您的UI使用metafield.translatable值来决定何时提供翻译。

有关完整的迁移示例，请参阅关于从 Translatable Resource Type.METAFIELD 迁移到 Metafield.translatable 的元字段翻译逻辑的指南。 从 TranslatableResourceType.METAFIELD 迁移到 Metafield.translatable。

相关文档

• translatableResources 查询
• TranslatableResourceType 枚举
• Shopify API 的版本控制
• Shopify 应用中的自定义数据