本页介绍了如何以编程方式上传和管理商品。借助 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
资源必须包含以下字段:
将商品信息上传到您的账号
如需将商品信息上传到您的账号,请使用 accounts.productInputs.insert
方法。您必须传递主要数据源或补充数据源的唯一标识符。
从您的账号中检索已处理的商品
如需从您的账号中检索已处理的商品,请使用 accounts.products.get
方法。添加后,处理好的商品可能需要几分钟才能显示。
您可以从 accounts.productInputs.insert
的响应中的 product
字段获取已处理商品的资源名称
从您的账号中删除商品信息
如需从您的账号中删除商品输入信息,请使用 accounts.productInputs.delete
方法。若要使用 Merchant Products API 删除商品,您必须传递商品所属的主要数据源或补充数据源的唯一标识符。
列出账号中的商品
如需列出您账号中已处理的商品,请使用 accounts.products.list
方法。