此页面由 Cloud Translation API 翻译。

Merchant API 概览

您可以使用 Merchant API 执行以下操作：

管理您的商家和商品在 Google 上的展示方式。
以程序化方式访问数据、分析洞见和独特功能。
发展业务，在 Google 上吸引更多客户。

Merchant API 可用于管理大型或复杂的 Merchant Center 账号。典型用例包括：

自动账号管理
自动化产品管理
自动化的产品目录管理系统
自动生成有关效果和市场洞见的报告

借助 Merchant API，您可以创建和管理多个数据源，从而更好地整理有关商品、促销活动和评价的信息。借助 Merchant API，您可以采用与文件和自动 Feed 等其他商品数据上传方法相辅相成的方式来管理商品。Merchant API 还允许您并行运行多个单独的请求。

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

Merchant API 的新变化

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

通过引入以下新方法，更好地管理商品目录数据：
通过创建和检索补充数据源，以及通过将补充数据源与主要数据源相关联，实现对补充数据源的管理。
启用商品数据变更通知，当商品状态发生变化时，系统会通知您，从而无需定期提取数据。
介绍了 accounts.autofeedSettings 资源以及用于检索和更新自动 Feed 设置的方法。
引入了商品评价和商家评价的上传功能。
引入了 accounts.productInputs 资源，以简化 accounts.products 资源。
支持与其他数据上传方法（例如文件）结合使用，以更新商品数据。
新的 NonProductPerformanceView 表，用于存储非商品效果数据，例如零售商网站的入站流量信息
模块化设计，可实现隔离且更频繁的功能改进
更新了文档和代码示例
更好地与 Google 的 API 改进提案保持一致
通过开发者注册，为开发者提供更好的支持和沟通。
更新了文档和代码示例。
通过开发者注册，为开发者提供更好的支持和沟通。

前期准备

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

Merchant Center 账号：您将通过此账号查询、更新和上传数据。请确保您拥有管理此账号中的商品和商品目录所需的权限。
Google Cloud 项目：使用该项目获取对您账号的 API 访问权限。
从您的 Merchant Center 账号到 Google Cloud 项目的关联。通过调用开发者注册方法来创建关联。您将使用此账号和这些用户来沟通 API 集成、调查和机会方面的事宜。

通过注册为开发者，将您的 Merchant Center 账号与 Google Cloud 项目相关联。具有 API 开发者角色的用户将收到 API 通信，包括强制性服务公告、开发者调查问卷和机会。

使用 Merchant API 进行身份验证

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

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

账号和商品标识符

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

请求网址格式

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

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

对于 list 和 get 等标准方法，系统会省略 :{METHOD} 部分。

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

DELETE https://merchantapi.googleapis.com/inventories/v1/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/v1/accounts/123456/regions?regionId=WA HTTP/1.1

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

如需详细了解特定服务，请参阅商家 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 方面的帮助。

提供反馈

如需提供反馈，请提交以下内容之一：

API 功能：在反馈表单的问题/疑问是什么？部分下，选择发送反馈选项。
文档：使用页面上的拇指评分和发送反馈按钮。
示例和库：在 GitHub 代码示例代码库中创建问题。

后续步骤

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

Latest updates

Design