Merchant Products API 概览

本页介绍了如何以编程方式上传和管理商品。借助 Merchant Products API,您可以在数据源中插入或更新商品、从账号中检索商品,以及从数据源中删除商品。

Merchant Products API 包含两个资源。

  • productInputs 表示产品的输入部分。
  • products 表示使用输入部分构建的经过处理的产品。

productInputs 可以是主要 Feed 也可以是补充 Feed,具体取决于其上传到主要数据源还是补充数据源。每个 product 都将由一个主要 productInput 和任意数量的补充 productInputs 构建而成。

您可以使用 Merchant Products API 创建网店或本地实体店目录,这些商品可以在多个购物平台上展示。创建 Merchant Center 账号、设置第一个数据源,并准备通过 API 上传初始商品集后,您就可以使用 productInputs 资源了。

虽然商家可以使用名为 PrimaryProductDataSource 的文件上传商品,但使用 Merchant API 创建和删除商品有诸多优势。这些优势包括响应时间更短,以及能够实时更新商品,而无需管理大型文件。对于通过 API 调用所做的商品更改,可能需要几个小时之后才能在购物数据库中显示。

前提条件

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

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

您有责任遵守购物广告非付费商品详情政策。如果我们发现违反这些政策的内容或行为,Google 购物广告保留强制执行这些政策的权利,并会做出适当的回应。

资源

借助 products 资源,您可以从 Shopping 数据库检索商品信息。

productInput 资源表示您为商品提交的输入数据。它还提供一些方法,允许您一次更新或删除一件商品的信息,或以批处理模式一次更新或删除多件商品的信息。productInput 资源必须包含以下字段:

  • channel:商品的渠道
  • offerId:商品的唯一标识符。
  • contentLanguage:商品的双字母 ISO 639-1 语言代码。
  • feedLabel:商品的 Feed 标签。

将商品信息上传到您的账号

如需将商品信息上传到您的账号,请使用 accounts.productInputs.insert 方法。您必须传递主要数据源或补充数据源的唯一标识符。

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

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

您可以从 accounts.productInputs.insert 的响应中的 product 字段获取已处理商品的资源名称

从您的账号中删除商品信息

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

列出账号中的商品

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