Merchant API 设计

我们设计的 Merchant API 既能让 Content API for Shopping 开发者感到熟悉,又更简单、更灵活。下面详细介绍了 Merchant API 的设计。

子 API

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

Merchant API 包含以下子 API:

  • 账号:大规模管理 Merchant Center 账号。
  • 商品:管理商品数据,例如价格和库存状况。
  • 数据源:查看和管理您商品的数据源。
  • 商品目录:在 Google 上按商店或地区展示您的产品。
  • 报告:查看有关商品、效果和 Google 上的竞争格局的数据。
  • 促销活动:创建和管理促销活动,以展示您商品的特别优惠。
  • 本地 Feed 合作伙伴关系: 上传本地商品目录 Feed。
  • 转化来源:管理账号的转化来源。
  • 通知:管理通知订阅。
  • 配额:查看您账号的 API 配额。

传输

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

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

枚举

Merchant API 中的枚举字段未来可能会公开新值。您的代码应以能够妥善处理无法识别的值的方式构建。您应监控无法识别的枚举值的出现情况,并采取措施来保持代码处于最新状态。

版本控制

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

以“beta”结尾的版本可能会发生变化,也可能会被移除。