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

注意 ：在 Merchant API 测试期间，我们可能会进行重大更改，而不会更新主版本。在进行重大更改之前，我们会至少提前 30 天发出通知。在测试期间，所有子 API 都将保留在 v1beta 版本。