Merchant API 设计

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

子 API

Merchant API 是一组 sub-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”结尾的版本可能会发生变化，也可能会被移除。