Shopify API 2027-01 移除 metafieldInteger 集合条件，整数值字段改为字符串

来源中的信息

发生了什么

根据事件 event:2d7fbad61f686437a092fd8e，Shopify 说明从 API 版本 2027-01 起，GraphQL Admin API 将移除 metafieldInteger 集合来源条件的输入和类型。

metafieldInteger 相关类型与字段将改为 metafieldInt，包括创建和更新集合条件时使用的输入字段，以及读取时使用的条件类型。

迁移后，整数元字段条件的 value 字段类型从 Int 改为 String；关系枚举成员保持不变。

该信息来自 Shopify Developer Changelog 的单一来源证据 evidence:2d7fbad61f686437a092fd8e，市场适用范围标注为全球；证据状态为 single-source，置信度为 0.72。

经营影响

这不是仅改名的接口更新：写入端需要同时处理 value 的类型变化，读取端也需要替换条件类型，因此只改一个字段名可能不足以完成兼容迁移。

影响范围集中在使用这些集合来源条件的 GraphQL Admin API 集成；未使用该条件的商家不应据此扩大改造范围。

升级 API 版本的时间点会把兼容性检查从可选维护事项变成上线前的接口依赖核对。

编辑观察

接口字段名和 value 类型同时变化，会让集合条件迁移涉及序列化、类型定义与读取分支，而不只是字符串替换；因此商家应把写入和读取路径作为一个兼容单元检查。证据明确支持字段替换和类型变化，但未提供具体 SDK、应用架构或失败表现。
对使用该条件的商家而言，风险主要落在依赖集合条件的后台工具或应用流程，而不是所有店铺功能；因此应先按代码或应用使用情况分层排查，避免对没有相关调用的系统进行无差别改造。证据未说明实际受影响应用数量或业务中断程度。
下一步决策应以 API 版本升级计划和实际调用痕迹为边界：若存在 metafieldInteger 的创建、更新或读取调用，就在升级前验证 metafieldInt 与字符串 value；若未发现调用，则保留记录并持续观察官方变更。当前证据未给出具体截止日期、弃用过渡期或兼容开关。

适用范围

使用自建应用、自动化脚本或后台工具通过 GraphQL Admin API 创建或读取相关集合条件的全球商家，需要检查接口字段和 value 类型。

仅通过未涉及该集合条件的标准店铺流程经营的商家，目前没有证据表明需要进行同等范围的技术改造。

依赖第三方应用的商家需要确认应用是否使用 metafieldInteger；现有证据不足以判断第三方应用是否已经完成适配。

行动建议

1
盘点 metafieldInteger 调用
this-week
在应用代码、GraphQL 查询和变更记录中搜索 metafieldInteger，分别标记创建、更新和读取路径；只对实际命中的集成安排迁移。
2
准备 metafieldInt 兼容改动
this-week
将相关字段切换为 metafieldInt，并把整数条件的 value 按字符串处理；同时更新读取分支中的条件类型。
3
在升级前验证读写链路
this-week
使用现有集合条件场景检查创建、更新和读取是否都能处理新的字段名称与 value 类型，再安排 API 版本升级。
4
跟踪官方后续说明
monitor
继续核对 Shopify Developer Changelog，重点关注 API 2027-01 的升级窗口、过渡安排或进一步兼容要求；当前证据未提供这些信息。

不要仅把 metafieldInteger 改名为 metafieldInt，却继续按 Int 写入 value；也不要在没有发现相关调用的情况下，将本次变更扩大为所有店铺功能的全面重构。

来源与依据

来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。