截至 GraphQL Admin API 2026-04 版本,InventoryLevel 对象现在包含一个 isActive 布尔字段,用于指示库存水平当前是否处于活动状态。在此版本中,您可以选择查询非活动的库存水平,而 isActive 字段将帮助您区分活动与非活动水平。
我们做出此变更的原因
以前,停用库存水平会清除其关联的数量,且这些非活动水平无法通过 API 查看。从 2026-04 版本开始,停用库存水平不再清除其数量。非活动水平可以像活动水平一样进行调整,因此 API 现在会返回这些非活动水平。isActive 字段提供了对激活状态的可见性,使应用程序能够区分从未进行过库存跟踪的位置和已停用跟踪的位置。
对您的应用的影响
从 GraphQL Admin API 2026-04 版本起,对 InventoryLevel 的查询可能会返回之前被排除的非活动库存水平。每个库存水平现在都包含一个 isActive 字段,您可以使用该字段来筛选或显示激活状态。
您需要执行的操作
- 现有查询无需进行任何更改,因为它们将继续仅返回活跃库存水平。
- 如果您选择在查询中包括非活动水平,请审查任何假设所有返回的库存水平均为活动的逻辑。如果您的应用程序仅需要活动的库存水平,请使用 isActive 字段来筛选结果。
- 更新任何库存水平计数或聚合,以考虑包含非活跃水平的情况。

