自 Customer Account API 版本 2026-10 起，客户地址输入和对象支持国家代码。现有的地区代码字段已弃用，但仍完全受支持，因此现有集成可继续正常运行而不会中断。在采用 API 版本 2026-10 时，开发人员应迁移至国家代码。 countryCode。现有的 territoryCode 字段已弃用，但仍完全受支持，因此现有集成可继续正常运行而不会中断。开发人员应在采用 countryCode 时迁移至国家代码。
变更内容
CustomerAddressInput 输入对象和 CustomerAddress 对象现在包含 countryCode。
在创建、更新或读取客户地址时使用 countryCode。它使用 CountryCode 枚举，并接受 ISO 3166-1 alpha-2 国家代码，例如 US 或 CA。
现有的 territoryCode 字段在 API 版本 2026-10 中被标记为已弃用。
注意： <code><span class="PreventFireFoxApplyingGapToWBR">territory<wbr/>Code</span></code> 并未被移除。继续使用它的现有查询和变更操作（包括使用较早 API 版本的集成）将继续按原样正常工作。
如果在地址输入中同时提供了这两个字段，countryCode 将优先生效。
受影响范围
此变更影响使用 Customer Account API 创建、更新或读取客户地址的应用。
使用 API 版本 2026-10 或更高版本的 App 可以使用 countryCode，并会看到 territoryCode 被标记为已弃用。使用 API 版本 2026-07 或更早版本的 App 保持不变，并可继续使用 territoryCode。
现有客户不会受到即时影响，且尚未公布任何移除版本。
为何重要
countryCode 使客户地址与 Shopify APIs 其他部分使用的国家代码术语以及强类型的 CountryCode 枚举保持一致。这提供了更清晰的输入要求，并避免了国家与地区术语之间的歧义。
操作指南
在采用 Customer Account API 版本 2026-10 时：
- 检查客户地址查询和变更操作中是否使用了 territoryCode。
- 将这些用法替换为 countryCode。
- 提供 ISO 3166-1 alpha-2 值，例如 US，而不是 alpha-3 或数值，如 USA 或 840。
- 针对 API 版本 2026-10 测试客户地址的创建、更新和读取功能。
停留在较早 API 版本的 App 无需立即进行更改。territoryCode 在版本 2026-10 中仍可使用，但迁移有助于使集成为其在未来 API 版本中可能被移除做好准备。
相关文档
- CustomerAddress
- CustomerAddressInput
- CountryCode