Merchant API 设计

我们设计的 Merchant API 与 Content API for Shopping 类似,但更简单、更灵活。下面详细介绍了 Merchant API 的设计。

子 API

Merchant API 是一组子 API。子 API 是相关服务和资源的集合。这种设计意味着您可以选择仅使用特定集成所需的子 API。

Merchant API 包含以下子 API:

  • 账号:大规模管理 Merchant Center 账号。
  • 转化: 管理账号的转化来源。
  • 数据源:查看和 管理商品的数据源。
  • **问题解决**:获取 影响账号的问题,并创建应用内诊断页面。
  • 商品目录: 在 Google 上按商店或区域展示 商品。
  • 本地 Feed 合作伙伴关系: 上传本地商品目录 Feed。
  • 通知:管理 通知订阅。
  • **订单跟踪**:提供 历史订单跟踪数据,以改进预计送达时间和使用送货注释增强 商品详情。
  • 商品:管理商品数据, 例如价格和库存状况。
  • Product Studio:使用 Google Product Studio 自动生成商品图片和文字建议。
  • 促销活动:创建和 管理促销活动,以展示商品的特别优惠。
  • Quota:检查 账号的 API 配额。
  • 报告:查看 Google 上商品、效果和竞争格局的数据。
  • 评价:管理商品和 商家评价。

传输

Merchant API 的默认传输机制是 gRPC。 您也可以使用 REST

如需了解详情,请参阅快速入门指南

枚举

Merchant API 中的枚举字段将来可能会公开新值。 您的代码应采用适当的结构,以便能够妥善处理无法识别的值。您应监控无法识别的枚举值的出现情况,并进行干预以使代码保持最新状态。

版本控制

子 API 会单独进行版本控制。这意味着,如果我们更新您未使用的子 API,您无需执行任何操作。只有在您使用的子 API 发布新版本时,您才需要更新代码。如需了解详情,请参阅 版本控制

以“beta”结尾的版本可能会更改或移除。