add_alert
重要提示: Content API for Shopping 已于 2026 年 8 月 18 日 停用。
warning
自
2026 年 9 月 1 日 起,Content API for Shopping 请求将
逐渐出现错误。请参阅
Content
API 停用指南。
Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。
管理您的商品
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 Products 子 API,您可以通过编程方式管理 Google Merchant Center 中的商品目录。您可以创建、检索、更新和删除商品,从而灵活地将您的系统直接与 Google 集成。
Merchant API 中的一个关键概念是,您提交的数据与 Google 使用的最终商品之间存在区别。这种分离提供了更清晰的商品数据生命周期模型,让您能够更精确地控制商品信息。该 API 通过两个主要资源来反映这一点:
ProductInput:这表示您提交到特定数据源的原始商品数据。您可以将其视为在 Merchant Center 进行任何处理之前,您在 Feed 文件中上传的行或通过 API 调用提交的数据。您可以使用此资源执行所有写入操作(insert、patch、delete)。
Product:这是一个只读资源,表示在 Merchant Center 和 Google 各平台上显示的最终处理后商品。它由一个主要 ProductInput 资源和零个或多个补充 ProductInput 资源构建而成,这些资源均已应用所有 Feed 规则和处理。此资源包含商品的最终状态和所有数据质量问题。您可以使用此资源执行所有读取操作(get、list)。
使用 ProductInput 资源提交的所有商品属性的格式和要求均在商品数据规范中定义。
Products sub-API 的用途
借助 Products 子 API,您可以执行以下关键任务。请参阅相关指南,了解每个用例的详细说明和代码示例。
- 添加和管理商品:了解如何向账号添加新商品、为现有商品提供补充数据,以及删除不再销售的商品。
- 频繁更新商品:了解如何高效地对经常变化的商品属性(例如价格和库存状况)进行部分更新。
- 列出商品数据和商品问题:了解如何检索已处理的商品、查看其在不同目标平台的审批状态,以及找出可能影响其曝光度的数据质量问题。
准备工作
在使用 Products sub-API 之前,您必须在 Merchant Center 账号中至少创建一个 API 数据源。Products 子 API 只能在类型为 API 的数据源中插入或更新商品。如需查看相关说明,请参阅管理用于上传商品的 API 数据源指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2026-10-28。
[null,null,["最后更新时间 (UTC):2026-10-28。"],[],["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"]]