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}

注意 ：标准方法省略了 :{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 支持 gRPC 和 REST。您可以通过以下两种方式调用 Merchant API：

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

注意 ：如果您使用客户端库，默认传输机制为 gRPC。在大多数情况下，您只需调用 Merchant API 端点即可使用 gRPC。

获取帮助

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

提供反馈

在 Beta 版发布期间，我们有机会在正式版发布之前收集并处理您的反馈。如需提供反馈，请提交以下任一项：

• API 功能：提交反馈表单
• 文档：使用页内缩略图评分和发送反馈按钮。
• 示例和库：请使用 GitHub 上的新建问题按钮。

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