Merchant Products API 概览

本页面介绍如何以程序化方式上传和管理商品。使用 Merchant Products API,您可以在数据源中插入或更新商品、从帐号中检索商品,以及从数据源中删除商品。

您可以使用 products 资源创建网店目录,即在购物广告上提供的商品列表。创建 Merchant Center 账号并准备好通过 API 上传一组初始商品后,您就可以使用 products 资源了。

您有责任遵守购物广告非付费商品详情政策。购物广告保留执行这些政策的权利,并且在我们发现违反这些政策的内容或行为时采取适当的应对措施。

products 资源会将商品信息上传到 Shopping Merchant Center 数据库。它还提供了多种方法,可让您一次访问、更新或删除商品信息,或在批量模式下一次访问、更新或删除商品信息。

productInput 资源表示您为商品提交的输入数据。productInput 资源必须具有以下字段:

  • channel:商品的渠道
  • offerId:商品的唯一标识符。商品输入和经过处理的商品的此值相同。
  • contentLanguage:商品的两个字母 ISO 639-1 语言代码。
  • feedLabel:商品的 Feed 标签。

虽然商家能够使用称为主要 Feed 的文件加载商品,但使用 Merchant API 创建和删除商品有几个优势。这些优势包括响应速度更快,以及能够实时更新多件商品,而无需管理多个补充 Feed。通过 API 调用所做的商品更改最多可能需要几个小时才能显示在 Shopping Merchant Center 数据库中。

Google 可以帮助您自动维护商品的某些属性。如需了解详情,请参阅启用自动改进

前提条件

如果您没有数据源,请使用 Merchant Data sources API 或 Merchant Center 创建数据源

如果您已有使用 Merchant Center 界面或 API 创建的数据源,则可以使用 Merchant Products API 来添加商品。如果您使用 Content API for Shopping 添加商品,请参阅迁移指南,了解如何开始使用 Merchant Products API。

将输入的商品上传到您的账号

如需将商品输入上传到您的账号中,请使用 accounts.productInputs.insert 方法。您必须传递主要数据源或补充数据源的唯一标识符,以使用 Merchant Products API 插入商品。

从您的帐号中检索已处理的商品

如需从您的帐号中检索已处理的商品,请使用 accounts.products.get 方法。插入后,处理后的商品可能需要几分钟才会显示。

从您的帐号中删除输入的商品

如需从您的帐号中删除商品输入,请使用 accounts.productInputs.delete 方法。您必须传递商品所属的主要数据源或补充数据源的唯一标识符,以使用 Merchant Products API 删除商品。

列出您账号中的商品

如需列出您帐号中已处理的商品,请使用 accounts.products.list 方法。