Google Merchant Center API

使用 Google Merchant API 管理您的账号。此工具可提高复杂商品数据管理的效率，从而提升购物广告的效果。本文介绍了 Google Merchant API 的优势、应用和设置说明。

Introducing Merchant API (Content API Successor)

如需查看您所用语言的字幕，请开启 YouTube 字幕。为此，请先选择视频播放器右上角的“设置”图标，再选择“字幕”，然后指定您的语言。

本页内容

什么是 Merchant API？
- 如何使用 Merchant API
- 优势
开始使用 Merchant API
- 开始前须知
- 使用 Merchant API 进行身份验证
通过 API 诊断功能调试 API 错误
常见问题解答

什么是 Merchant API？

Merchant API 可让您直接与 Merchant Center 账号交互，并遵循一种新的设计理念，可随着变化加快创新速度。它是 Content API for Shopping 的重新设计版本和官方继任者，取代了后者，成为以编程方式大规模管理复杂设置的主要方式。

Merchant API 可实现对账号、产品和商品目录管理的自动化，并提供效果报告，从而大幅提高管理大型或复杂账号的效率。它可为 Google 上的自然搜索和购物广告体验提供支持，是 Merchant Center 平台的补充接口。

Merchant API: New Features & AI Tools [2026 Guide]

如需查看您所用语言的字幕，请开启 YouTube 字幕。为此，请先点击视频播放器右上角的设置图标，再选择字幕，然后指定您的语言。

如何使用 Merchant API

借助 Merchant API，您可以以编程方式管理和控制您的商家和商品在 Google 上的展示方式。借助新设计的界面，您可以轻松地大规模访问数据、分析洞见和独特功能。借助它，您可以创建和管理多个数据源，从而更好地整理有关商品、促销活动和评价的信息。借助 Merchant API，您可以采用与文件和自动 Feed 等其他商品数据上传方法相辅相成的方式来管理商品。借助 Merchant API，您还可以并行运行多个单独的请求。

使用 Merchant API 可以：

以程序化方式访问 Google 内外的购物体验数据、分析洞见和功能。
通过高级设置、报告、分析洞见和通知，提升自然流量和广告体验。
利用 API 的模块化结构，以与时俱进的速度进行创新。

可以使用 gRPC 或 REST 访问该 API。为了帮助您入门，Merchant API 界面支持所有热门编程语言，包括 Java、PHP、Python、Node.js、.NET 和 Apps 脚本。

优势

利用最新技术：受益于更快、更高效的 API，确保您的设置能够迎接下一波创新浪潮。
更高效地升级：借助新的模块化设计，您可以更快、更轻松地实现变更并推出新功能。
简化数据管理：通过一个简化的界面轻松控制多源 Feed、地区性库存状况和具体商店的库存。
解锁仅通过 API 提供的专有功能：获取强大的工具，例如 Google Product Studio，可用于生成 AI 赋能的图像和直接接收账号通知。

开始使用 Merchant API

How to Migrate to Merchant API

如需查看您所用语言的字幕，请开启 YouTube 字幕。为此，请先点击视频播放器右上角的设置图标，再选择字幕，然后指定您的语言。

开始前须知

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

Merchant Center 账号：您将通过此账号查询、更新和上传数据。确保您拥有管理此账号中的商品和商品目录所需的权限。
Google Cloud 项目：该项目用于获取对您账号的 API 访问权限。
注册至少一位具有 API 开发者角色的用户：完成一次性开发者注册，将您的 Merchant Center 账号与 Google Cloud 项目相关联。关联的账号的 API 开发者用户将收到 API 通信，包括重要服务通知、开发者调查问卷和优化建议。

使用 Merchant API 进行身份验证

您可以使用 Google APIs Explorer 运行 Merchant API 请求。API Explorer 使用 Google OAuth 2.0 进行身份验证。在运行请求之前，请确保已勾选“Google OAuth 2.0”复选框。

如需使用 OAuth 2.0 进行身份验证，您需要登录自己的 Google 账号，然后登录 API Explorer。您还需要允许 APIs Explorer 管理您的商品详情和账号。

详细了解 Merchant API 使用入门。

通过 API 诊断功能调试 API 错误

API 请求出错可能会导致您的商店无法管理商品在 Google 上的展示情况，也无法触达线上客户。如需诊断和修复 API 请求中的错误，请访问“API 诊断”标签页，该页面可帮助您：

查看选定时间段内所有成功和失败的 API 请求
确定每种 API 版本、服务和方法对应的成功和失败请求数
查看失败请求的示例

注意：您可以在 Merchant Center 中使用 API，同时不使用 API 诊断工具。如果您想在 Merchant Center 中获取有关 API 错误的数据分析，请确保 API 诊断插件已启用。不妨详细了解如何在 Merchant Center 中启用插件。

查找 API 诊断

API 请求出错可能会导致您的商品无法在 Google 上展示。请参照以下步骤检查这些错误：

在您的 Merchant Center 账号中，前往左侧导航菜单中的设置图标。
选择 API 诊断。

在“API 诊断”页面中，您可以监控、诊断并修复 API 请求中的错误。您还可以识别在不同 API 版本中可能导致严重错误的方法。

查看 API 请求

“API 诊断”页面包含以下两个主要部分：

您的 API 调用次数：一张时间轴图，显示特定时间段内成功和失败的 API 请求数。
API 调用的性能：一个表格，显示 API 请求总数和失败的 API 请求数。

注意：图上的时间戳使用的是账号设置中指定的时区。

如需查看 API 请求，请执行以下操作：

在您的 Merchant Center 账号中，选择左侧导航菜单中的设置。
选择 API 诊断。
使用“时间段”过滤条件指定相应时间段。
使用页面顶部的过滤条件栏指定要查看的 API 服务请求和方法（例如，使用了“insert”方法的商品）。表格和时间轴都会更新，以显示特定 API 服务请求和方法。

查看失败的 API 请求

选定的数据范围所对应的结果在表格中显示后，您可以浏览所列的服务和方法，快速判断 API 请求失败的原因。默认情况下，错误按服务名称排列，不过您可以通过点击列标题来更改排列顺序。

如需查看失败的请求，请执行以下操作：

在您的 Merchant Center 账号中，选择左侧导航菜单中的设置。
选择 API 诊断。
前往“API 调用的性能”表，然后选择“调用失败的次数”列下的项，以查看失败的 API 请求的更多详情。
请参照“商品/插入的所有错误”部分下显示的详细信息来修复失败的 API 请求。

常见问题解答

Merchant API 与 Content API for Shopping 是否相同？

Merchant API 是对 Content API for Shopping 的重新设计，后者现已弃用。它提供了增强的功能，可用于自动管理账号和商品数据。

什么是 Content API for Shopping？

Content API for Shopping 是一款旧版 Google 工具，可让开发者以编程方式管理商品数据。该 API 已重新设计，并由 Merchant API 取代。如需使用最新的自动化账号管理功能，您应迁移到新的 Merchant API。

该内容对您有帮助吗？

您有什么改进建议？