Merchant API 概览

本页介绍了 Merchant API，并说明了如何使用它来自动执行与在 Merchant Center 上管理账号、商品和商品目录相关的各种工作流。

您可以使用 Merchant API 来吸引更多客户，并在 Google 各平台上展示您的商品。您可以使用 Merchant API 管理大型或复杂的 Merchant Center 账号。一些典型的用例包括：

  • 自动账号管理
  • 自动化产品管理
  • 自动化的产品目录管理系统
  • 自定义报告

借助 Merchant API，您可以创建和管理多个数据源，从而更好地组织商品、促销活动和评价的相关信息。借助 Merchant API，您可以对商品进行管理，对其他商品数据上传方法（如文件和自动 Feed）进行补充。借助 Merchant API，您还可以并行运行多个单独的请求。

Merchant API 是对 Content API for Shopping 的重新设计，包含多个子 API。

零售商有责任遵守购物广告和非付费商品详情政策。Google 购物有权执行这些政策，并在发现违反这些政策的内容或行为时做出适当回应。

Merchant API 的新变化

以下是升级到 Merchant API 的一些原因：

如需了解详情，请参阅 Merchant API Beta 版中引入的新功能。

前期准备

如需运行 Merchant API 请求，您必须满足以下条件：

  • Merchant Center 账号：您要查询、更新和上传数据的账号。请确保您拥有管理此账号中的商品和商品目录的必要权限。

  • Google Cloud 项目：该项目用于获取对您账号的 API 访问权限。

使用 Merchant API 进行身份验证

您可以使用以下选项进行身份验证：

  • 您可以为应用生成 OAuth 2.0 客户端 ID 和密钥。然后，您可以使用该 ID 和密钥生成对 Merchant Center 账号的 API 调用所需的 OAuth 2.0 凭据。
  • 您可以创建服务账号并下载其私钥以进行 API 调用。

账号和商品标识码

Merchant API 使用资源名称（而不是 ID）进行标识。例如，产品的资源名称可以是 accounts/123456/products/online~en~US~sku123，其中 123456 是账号的唯一标识符，online~en~US~sku123 是产品的唯一标识符。

请求网址格式

如需对资源执行操作，请按以下格式向网址发送请求：

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

list 和 get 等标准方法省略了 :{METHOD} 部分。

例如，以下请求会删除地区商品目录：

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

如需创建资源，您可以使用父资源的资源名称和以下网址：

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

例如，以下请求展示了如何为 accounts/123456 创建区域：

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

Merchant API 使用入门

如需快速了解 Merchant API 的工作原理并尝试上传示例商品，请参阅 Merchant API 使用入门。

使用 gRPC 或 REST

Merchant API 支持 gRPC 和 REST。以下是调用 Merchant API 的两种方法：

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

使用客户端库和代码示例

每个子 API 都有可帮助您入门的客户端库。代码示例可帮助您开始使用 Java、PHP 和 Python 编写代码。如需了解详情，请参阅 Merchant API 示例。

获取帮助

如需获取支持资源，请参阅获取 Merchant API 方面的帮助。

提供反馈

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

  • API 功能：提交反馈表单
  • 文档：使用页内缩略图评分和发送反馈按钮。
  • 示例和库：在 GitHub 代码库中为代码示例创建问题。

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

后续步骤

  • 如需了解向后兼容性，请参阅 Content API for Shopping 兼容性。

  • 如需详细了解 Merchant API 的主要功能，请参阅左侧导航菜单中的指南。

  • 如需了解可用的资源和服务，请参阅参考文档。

下一页
Design