Merchant API v1beta 已于 2026 年 2 月 28 日停用并关停。如需了解迁移到最新稳定版的步骤,请参阅
从 v1beta 迁移到 v1。
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
管理您的商品
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 Products 子 API,您可以以编程方式管理 Google Merchant Center 中的商品目录。您可以创建、检索、更新和删除商品,从而灵活地将您的系统直接与 Google 集成。
Merchant API 的一个关键概念是您提交的数据与 Google 使用的最终商品之间的区别。这种分离可以更清晰地呈现商品数据生命周期模型,让您能够更精确地控制商品信息。该 API 通过两个主要资源反映了这一点:
ProductInput:此元素表示您向特定数据源提交的原始商品数据。
您可以将此视为您在 Feed 文件中上传的行,或通过 API 调用提交的数据(在 Merchant Center 进行任何处理之前)。您可以使用此资源执行所有写入操作(insert、patch、delete)。
Product:这是一个只读资源,表示最终经过处理的商品在 Merchant Center 和 Google 各平台上的显示方式。它是在应用所有 Feed 规则和处理操作后,由一个主要 ProductInput 和零个或多个补充 ProductInput 资源构建而成。此资源包含商品的最终状态和任何数据质量问题。您可以使用此资源进行所有读取操作(get、list)。
使用 ProductInput 资源提交的所有商品属性的格式和要求均在商品数据规范中定义。
您可以利用 Products 子 API 执行的操作
借助 Products 子 API,您可以执行以下关键任务。请参阅相关指南,详细了解每种使用情形的说明和代码示例。
- 添加和管理商品:了解如何向账号添加新商品、为现有商品提供补充数据,以及删除您不再销售的商品。
- 频繁更新商品数据:了解如何高效地部分更新经常变化的商品属性,例如价格和库存状况。
- 列出商品数据和商品问题:了解如何检索已处理的商品、查看商品在不同目标平台上的审批状态,以及识别可能影响商品展示的任何数据质量问题。
准备工作
在使用 Products 子 API 之前,您必须在 Merchant Center 账号中至少创建一个 API 数据源。Products 子 API 只能在类型为 API 的数据源中插入或更新商品。如需了解相关说明,请参阅管理用于商品上传的 API 数据源指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-05-18。
[null,null,["最后更新时间 (UTC):2026-05-18。"],[],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"]]