从 API 版本 2026-07 开始,GraphQL Admin API 支持渠道市场。应用现在可以创建和更新适用于一个或多个销售渠道的市场,然后使用现有的目录和市场 API 来管理特定于渠道的产品可用性、定价和货币。
这是一个增量变更。现有应用无需进行更新,除非它们创建、查询或对市场(Markets)或市场目录类型做出假设。
变更内容
您现在可以:
- 使用 MarketType.CHANNEL 和 MarketConditionType.CHANNEL 来识别渠道市场。
- 通过 MarketCreateInput.conditions.channelsCondition 和 MarketConditionsChannelsInput.channelIds 创建渠道市场。
- 通过 MarketUpdateInput.conditions 添加或移除渠道条件。
- 使用 Market.channels 和 Market.channelsCount 查询市场的渠道。
- 使用 Channel.markets 和 Channel.marketsCount 查询渠道的市场。
- 使用 Channel.activeRegions 读取渠道具有活跃产品馈送的地区。
- 使用 markets(type: CHANNEL) 按类型筛选市场。
操作指南
如果您的应用与市场(Markets)或目录相关,请更新任何假设市场仅为区域型、零售门店型、公司门店型或非类型市场的逻辑。
如果应用希望创建渠道市场,请通过 channelsCondition.channelIds 传递渠道 ID,然后使用现有的市场和目录 API 分配目录和定价配置。产品馈送输出将继续同时尊重渠道市场的目录设置和销售渠道自身的发布控制。
相关文档
- Market Market 对象
- Channel Channel 对象
- MarketConditionsChannelsInput
- MarketType Market Type 枚举
- Channel 配置扩展

