Merchant Data sources API 概览

此页面介绍了如何以编程方式创建和更新 供您插入商品。自动数据 来源 将您的商品数据提供给 Google。自动化数据源可确保 Google 就会获得您网站上相关商品的最新信息。

Content API for Shopping 仅允许您创建主要数据源，包含 Merchant Data source API 中，因此您可以创建以下类型的数据源：

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

使用 Merchant Data sources API，您可以执行以下操作：

  • 创建具有特定“feedLabel”和 contentLanguage。
  • 创建通配符数据源。通配符数据源没有 feedLabel 和 contentLanguage 字段。借助通配符数据源，您可以 将 feedLabel 和 contentLanguage 的不同组合组合为 数据源
  • 创建补充数据源，以关联至现有的主要数据源。
  • 为文件数据源设置时间表。
  • 管理 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.

创建新的数据源

创建具有特定 feedLabel 和 contentLanguage，请设置 feedLabel 和 contentLanguage 字段， 特定于类型的配置。例如 PrimaryProductDataSource。

如需查看您新创建的数据源，请创建 GET 或 LIST 请求。

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

要创建新的通配符主要 Feed，请使用以下属性配置数据源： PrimaryProductDataSource 请勿设置 feedLabel 和 contentLanguage 字段。

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

只有包含 API 输入的数据源才能成为通配符数据源。通配符数据 来源。

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

您可以使用补充数据源对商品数据进行部分更新，具体方法如下： 添加数据源的唯一标识符作为查询参数 对 accounts.productInputs.insert 和 accounts.productInputs.delete 方法。您只能使用补充数据源来更新现有商品。

要创建补充数据源，请使用以下代码配置数据源： SupplementalProductDataSource，然后通过更新 defaultRule 来关联该账号 字段。

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

为文件数据源设置时间表

要为您的文件 Feed 设置计划，请将您的数据源配置为文件 使用 FileInput 字段指定数据源，然后设置 fetchsettings 使用FileInput.FetchSettings字段

删除数据源

要从账号中删除现有数据源，请使用 accounts.dataSources.delete 方法。

提取数据源

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

获取数据源

要检索您账号的数据源配置，请使用 accounts.dataSources.get 方法。

列出数据源

要列出您账号的数据源配置，请使用 accounts.dataSources.list 方法。

修补数据源

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