Merchant API 使用入门

在您的 Cloud 项目 。

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 上的 New issue 按钮。

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