来源中的信息
发生了什么
Shopify Developer Changelog 发布的事件 event:eae6dd967459d57122f686f9，证据 evidence:eae6dd967459d57122f686f9 表明：GraphQL Admin API 版本 2026-10 在 Metafield 对象上新增非空字段 translatable: Boolean!。
该字段直接返回平台已用于判断某个 Metafield 值是否可翻译的结果，适用于全局市场中调用 2026-10 或更高版本并读取可翻译 Metafield 的应用。
在 2026-10 及更高版本，应用应读取 Metafield 对象上的 translatable，而不是继续通过已弃用的 TranslatableResourceType.METAFIELD 查询；版本 2026-07 及更早版本不提供该字段。
不按店铺查询可翻译 Metafield，或仅读取 Metafield 值而不判断其可翻译性的应用，不受此次变化影响；该更新不新增访问权限范围，也没有功能预览。
经营影响
为什么重要
应用可以从具体 Metafield 对象获得平台判断结果，减少维护可翻译 Metafield 类型清单的需要。
对多语言店铺而言，API 版本升级会改变应用获取可翻译属性的推荐路径，但影响范围集中在相关应用集成，而不是所有 Shopify 店铺。
编辑观察
分析判断
这更像一次 API 读取路径的收敛，而不是商家端功能扩展：新版本把可翻译性判断放回 Metafield 对象，应用迁移时应优先调整查询和兼容逻辑。
由于字段只在 2026-10 及更高版本出现，直接删除旧枚举查询会破坏仍运行在 2026-07 或更早版本的请求；版本分流应先于代码替换。
此次变化没有新增访问权限范围，因此排查重点应放在 API 版本、查询字段和弃用路径，而不是重新申请权限。
适用范围
对卖家的影响
使用第三方多语言、内容同步或后台自动化应用的全球商家，只有在该应用同时升级到 2026-10 以上并读取可翻译 Metafield 时，才可能受到集成层变化影响。
商家本身不需要因为该字段新增而修改商品内容；实际影响取决于所用应用是否查询并处理 Metafield 的可翻译性。
行动建议
现在应该做什么
- 1
盘点应用的 API 版本与 Metafield 查询
this-week在应用代码或供应商文档中确认是否调用 GraphQL Admin API 2026-10 以上版本，以及是否读取可翻译 Metafield；重点标记仍使用 TranslatableResourceType.METAFIELD 的路径。
- 2
为版本迁移保留兼容分支
this-week对迁移到 2026-10 以上的请求改为读取 Metafield 对象上的 translatable；对 2026-07 及更早版本继续保留现有处理方式，并在测试环境验证两条路径。
- 3
跟踪应用供应商的迁移说明
monitor如果商家不维护相关应用代码，向多语言或内容自动化应用供应商确认其是否已适配 2026-10；未使用可翻译 Metafield 的应用可暂不安排变更。
暂时不要做什么
- 不要在未确认 API 版本的情况下删除 TranslatableResourceType.METAFIELD 相关逻辑，也不要把此次更新扩大解读为所有 Shopify 商家都必须立即升级。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
API version 2026-10 adds a non-null translatable field to the Metafield object in the GraphQL Admin API. Apps that fetch translatable metafields and migrate to 2026-10 can now see whether a metafield’s value is translatable directly on the metafield itself. If your app doesn’t query for translatable metafields by shop, you don’t need to change anything. What changed The Metafield object in the GraphQL Admin API exposes a new non-null field, translatable: Boolean!, in API version 2026-10: { product(id: "gid://shopify/Product/1") { metafield(namespace: "custom", key: "care_guide") { type # "single_line_text_field" translatable # true } } } translatable returns the result that the platform already enforces when it decides whether a metafield’s value can be translated. Before this change, apps had to use the deprecated TranslatableResourceType.METAFIELD enum on translatableResources to query for translatable metafields. On API version 2026-10 and later, you should read translatable on the Metafield object instead of querying metafields through translatableResources. Who's affected This applies to apps that: Call the GraphQL Admin API on version 2026-10 or later, and Fetch translatable
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年9月21日 16:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.