我们设计的 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 的新版本发布时更新代码。有关详情,请参阅版本控制。