已核验事实
发生了什么
Shopify 官方开发者更新称,从 Customer Account API 版本 2026-10 起,CustomerAddressInput 和 CustomerAddress 支持 countryCode;territoryCode 同时被标记为弃用,但仍可继续使用。
countryCode 使用 CountryCode 枚举,并接受 ISO 3166-1 alpha-2 代码,例如 US 或 CA;如果同一地址输入同时提供两个字段,countryCode 优先。
使用 API 版本 2026-07 或更早版本的应用不受本次字段变化影响,既有 territoryCode 查询和变更操作仍可运行;Shopify 尚未公布 territoryCode 的移除版本。
本更新主要影响北美市场中使用 Customer Account API 创建、更新或读取客户地址的应用;普通未使用该 API 的店铺流程不在已给证据覆盖范围内。
经营影响
为什么重要
2026-10 版本将 territoryCode 标记为弃用,因此应用升级 API 版本时需要同步检查地址读写逻辑,避免新旧字段混用造成数据优先级差异。