Merchant API v1beta 已于 2026 年 2 月 28 日停用并关停。如需了解迁移到最新稳定版的步骤，请参阅从 v1beta 迁移到 v1。

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 和密钥生成向 Merchant Center 账号发出 API 调用时所需的 OAuth 2.0 凭据。
您可以创建服务账号并下载其私钥，以进行 API 调用。

账号和商品标识符

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

请求网址格式

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

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

对于列表和获取等标准方法，:{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"
  }
}

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

提供反馈

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

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

后续步骤

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

Latest updates

Design