Merchant API 设计

我们设计的 Merchant API 既能让 Content API for Shopping 开发者感到熟悉,又更加简单灵活。以下是有关 Merchant API 设计的一些详细信息。

Sub-API

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

Merchant API 包含以下 sub-API:

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

传输

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

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

枚举

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

版本控制

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