Merchant API 使用入门

首先,在您的 Cloud 项目中启用 Merchant API。

以下是使用 Merchant API 的方法:

使用客户端库

Merchant API 由多个子 API 组成。

每个子 API 都提供了代码示例客户端库,可帮助您轻松上手。

如果您已在使用 Content API for Shopping,请参阅 Content API for Shopping 兼容性

发送请求

Merchant API 使用资源名称(而非 ID)进行标识。产品的资源名称示例为 accounts/123/products/online~en~US~sku123,其中 123 是账号的唯一标识符,online~en~US~sku123 是产品的唯一标识符。

如需对资源执行操作,请向以下格式的网址发送请求:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

例如,以下请求会删除地区商品目录:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

如需创建新资源,您可以使用父级资源的资源名称和以下网址

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

例如,您可以通过以下方式为 account/123 创建新的区域

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

如需详细了解特定服务,请参阅 Merchant API 参考文档

使用 gRPC 或 REST

Merchant API 支持 gRPCREST。您可以通过以下两种方式调用 Merchant API:

gRPC(推荐) REST
  1. 将请求正文创建为协议缓冲区。
  2. 使用 HTTP/2 将请求正文发送到服务器。
  3. 将响应反序列化为协议缓冲区。
  4. 解读结果。
  1. 将请求正文创建为 JSON 对象。
  2. 使用 HTTP 1.1 将其发送到服务器。
  3. 将响应反序列化为 JSON 对象。
  4. 解析结果。

获取帮助

如需了解如何获取支持,请参阅获取 Merchant API 帮助

提供反馈

在 Beta 版测试期间,我们有机会在正式版发布之前收集和解决您的反馈。如需提供反馈,请提交以下任一内容:

  • API 功能:提交反馈表单
  • 文档:使用页面上的拇指评分和发送反馈按钮。
  • 示例和库:请使用 GitHub 上的新建问题按钮。

如需在实现每项任务后提供一般反馈,请使用反馈表单