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”结尾的版本可能会更改或移除。