此页面由 Cloud Translation API 翻译。

Merchant API 概览

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

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

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

借助 Merchant API，您可以创建和管理多个数据源，从而更好地整理商品、促销活动和评价的相关信息。借助 Merchant API，您可以以与文件和自动 Feed 等其他商品数据上传方法相辅相成的方式管理商品。

Merchant API 是对 Content API for Shopping 的重新设计，由多个子 API 组成。

零售商有责任遵守购物广告和非付费商品详情政策。Google 购物保留强制执行这些政策的权利，如果发现违反这些政策的内容或行为，将会采取适当措施。

Merchant API 中的新变化

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

引入了以下新方法，更好地管理商品目录数据：
通过创建和检索补充数据源，以及将补充数据源关联到主要数据源，实现补充数据源的管理。
启用商品数据更改通知，在商品状态发生变化时通知您，从而无需定期提取。
介绍了 accounts.autofeedSettings 资源以及用于检索和更新自动 Feed 设置的方法。
介绍了如何上传商品评价和商家评价。
引入了 accounts.productInputs 资源，简化了 accounts.products 资源。
可与文件等其他数据上传方法结合使用，以更新商品数据。
新增了NonProductPerformanceView 表格，用于显示非商品效果数据，例如有关零售商网站的流量信息。
模块化设计，可隔离功能并更频繁地进行功能改进。
与 Google 的 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
将请求正文创建为协议缓冲区。使用 HTTP/2 将请求正文发送到服务器。将响应反序列化为协议缓冲区。解读结果。	将请求正文创建为 JSON 对象。使用 HTTP 1.1 将其发送到服务器。将响应反序列化为 JSON 对象。解析结果。

使用客户端库和代码示例

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

获取帮助

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

提供反馈

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

API 功能：提交反馈表单
文档：使用页面上的拇指评分和发送反馈按钮。
示例和库：在 GitHub 代码库中创建问题。

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

后续步骤

如需了解向后兼容性，请参阅 Content API for Shopping 兼容性。
如需详细了解 Merchant API 的关键功能，请参阅左侧导航菜单中的指南。
如需了解可用资源和服务，请参阅参考文档。

设计