Merchant Data sources API 概览

本页面介绍了如何以编程方式创建和更新用于插入商品的数据源。自动化数据源可让您更轻松地向 Google 发送商品数据。自动化数据源可确保 Google 能够收到您网站上相关商品的最新信息。

Content API for Shopping 仅允许您创建主要数据源,使用 Merchant Data sources API,您可以创建以下类型的数据源:

Content API for Shopping 只允许管理包含文件输入的数据源,借助 Merchant API,您可以同时使用文件和 API 输入来管理数据源。

使用 Merchant Data sources API,您可以执行以下操作:

  • 使用特定的 feedLabelcontentLanguage 创建新的主要数据源。
  • 创建通配符数据源。通配符数据源未设置 feedLabelcontentLanguage 字段。借助通配符数据源,您可以将具有不同 feedLabelcontentLanguage 组合的商品插入到数据源中。
  • 创建补充数据源,以关联至现有的主要数据源。
  • 为文件数据源设置时间表。
  • 管理 API 数据源。
  • 使用其他类型的数据源,例如促销活动。

前提条件

  • 您的帐号必须已迁移至单一语言区域 Feed
  • 如需验证帐号是否已迁移到数据目标拆分,请使用数据源列表或 get 方法。如果您不符合条件,则会收到以下异常消息,并与支持团队联系。

    This account is in the data sources migration process and can't be used with
    this API yet. Contact support for more info on when this account will be able
    to use the data sources endpoint.
    

创建新的数据源

如需创建具有特定 feedLabelcontentLanguage 的新主要数据源,请在特定于类型的配置中设置 feedLabelcontentLanguage 字段。例如 PrimaryProductDataSource

如需查看您新创建的数据源,请创建 GETLIST 请求。

创建新的通配符主要数据源

如需创建新的通配符主要 Feed,请使用 PrimaryProductDataSource 配置数据源,并且不要设置 feedLabelcontentLanguage 字段。

使用 Content API for Shopping 时,系统仅会为您创建一个 API 数据源。使用 Merchant Data sources API,您可以拥有多个 API 数据源,其中一些可以是通配符。

只有包含 API 输入的数据源才能成为通配符数据源。文件输入不支持通配符数据源。

创建补充数据源并将其与主要数据源相关联

调用 accounts.productInputs.insertaccounts.productInputs.delete 方法时,您可以通过将数据源的唯一标识符添加为查询参数,使用补充数据源对商品数据进行部分更新。您只能使用补充数据源来更新现有商品。

如需创建补充数据源,请使用 SupplementalProductDataSource 配置数据源,然后通过更新主要数据源上的 defaultRule 字段来关联该数据源。

补充文件数据源不能是通配符数据源。补充 API 数据源必须始终是通配符数据源。

为文件数据源设置时间表

如需为文件 Feed 设置时间表,请使用 FileInput 字段将数据源配置为文件数据源,然后使用 FileInput.FetchSettings 字段设置 fetchsettings

删除数据源

如需从帐号中删除现有数据源,请使用 accounts.dataSources.delete 方法。

提取数据源

如需提取数据源中配置的文件,请使用 accounts.dataSources.fetch 方法。此方法会立即对您帐号中的数据源执行数据提取。此方法仅适用于具有文件输入集的数据源。

获取数据源

如需检索帐号的数据源配置,请使用 accounts.dataSources.get 方法。

列出数据源

如需列出帐号的数据源配置,请使用 accounts.dataSources.list 方法。

修补数据源

如需更新现有数据源的配置,请使用 accounts.dataSources.patch 方法。