目录 API 现在在每个产品变体上返回商家的对比价格 list_price。您的应用或智能体可以使用 list_price 来判断产品是否降价以及降价幅度。该 price 字段不会发生变化。无需采取任何操作。
list_price 是 UCP 目录规范，版本 2026-08-25 中定义的一个可选字段。它使用与 price 相同的 Price 对象，其中包含以最小单位计数的 amount 和 currency。产品还会返回 list_price_range，其中包括其所有变体中的最低和最高 list_price。
当满足以下所有条件时，变体将包含 list_price：
- 商家通过 Shopify 管理后台的目录映射（Catalog Mapping）分享对比价格。Shopify 默认对大多数商店启用此功能，而对于使用对比价格作为建议零售价（MSRP）或其他参考价格的商店，则默认关闭此功能。
- 对比价格高于买家上下文下的 price。
- 商家在买家的地区展示对比价格。对欧盟经济区（EEA）买家隐藏这些价格的商店不会向这些买家返回 list_price。
当缺少 list_price 时，该变体对于该买家和配置没有可展示的对比价格。如何在您的用户界面或智能体的响应中呈现这一点由您决定。
了解 list_price 如何出现在 全球目录响应 中。