在 API 版本 2026-10 中，GraphQL Admin API 现在包含用于查询和遍历商店市场层次结构的字段。使用 read_markets 访问范围的 App 可以检索父子关系、在相关市场之间导航，并检查异步重建的关系数据是否已更改。现有 App 无需采取任何操作。
变更内容
新的 marketRelationships 查询返回一个 MarketRelationship 对象连接。每个关系都包含一个 childMarket 和一个可为空的 parentMarket。如果 childMarket 是根市场，则 parentMarket 字段为 null。
Market 对象现在包括：
- parentMarkets：该市场的直接父级市场。
- parentMarketsCount：直接父级市场的数量。
- childMarkets：该市场的直接子级市场。
- childMarketsCount：直接子级市场的数量。
MarketRelationship 只要重建后直接关系仍然存在，Shopify 在重建关系数据时 ID 将保持稳定。连接游标（Connection cursors）在重建过程中可能会发生变化，因此检测到变化后应重新启动分页。
在市场层次结构更改后，市场关系会异步重建。marketRelationshipsStatus 查询返回一个不透明的 version 值，您可以将其与之前检索到的值进行比较。version 值的更改表明物化的市场关系已更新。
您应在进行影响层次结构的更改之前检索 version，在单独的请求中进行轮询，并在该值更改后重新获取关系。不要将在同一请求中检索到的 version 视为 marketRelationships 快照标识符。
受影响对象
此更改适用于使用 GraphQL Admin API 版本 2026-10 或更高版本且需要检查或遍历市场关系的 App。
使用 2026-10 之前版本的 API 的 App 无法查询新字段。不查询市场的 App 不受影响。
为何重要
您可以直接从市场关系中重构商店的市场层级结构，而无需从市场条件、自定义状态或其他间接信号中推断。
操作指南
现有应用无需采取任何操作。您的现有集成在旧版 API 上仍可正常工作，无需更改。
要使用市场层级字段：
- 请使用 GraphQL Admin API 版本 2026-10 或更高版本。
- 确认您的 App 具有 read_markets 访问范围。
- 查询 marketRelationships，或将父级和子级字段添加到 Market 查询中。
- 如果您的 App 更改了市场层次结构，请在更改之前检索 marketRelationshipsStatus.version，并在之后通过单独的请求对其进行轮询。
- version 更改后，请重新启动分页并重新获取关系数据。这可确保您的 App 使用最新的物化关系。
相关文档
- 市场继承
- 2026-10 GraphQL Admin API 参考