此页面由 Cloud Translation API 翻译。

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，您可以执行以下操作：

使用特定的 feedLabel 和 contentLanguage 创建新的主数据源。
创建一个未设置 feedLabel 和 contentLanguage 字段的数据源。使用这种类型的数据源，您可以定位多个国家/地区因为您可以插入具有不同组合的将 feedLabel 和 contentLanguage 整合到单个数据源中。
创建补充数据源，以关联至现有的主要数据源。
为文件数据源设置时间表。
注册您的账号，以便自动管理数据源。
管理 API 数据源。
使用主要商品数据源管理数据源的默认规则。
使用其他类型的数据源，例如促销活动。

您无法使用 Merchant 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.
```

创建新的数据源

主要数据源是 Merchant Center 商品目录的主要数据源。您只能使用主要数据源添加或移除商品。如果您添加到主要数据源的每件商品都符合 Merchant Center 的数据和资格要求，则无需创建更多数据源。

创建具有特定 feedLabel 和 contentLanguage，请设置 feedLabel 和 contentLanguage 字段，特定于类型的配置。如需详细了解这些字段请参阅 PrimaryProductDataSource。

如需详细了解如何创建数据源，请参阅 accounts.dataSources.create 方法。

要查看新创建的数据源，请使用 accounts.dataSources.get 或 accounts.dataSources.list 方法。

创建新的主要数据源，以帮助定位多个国家/地区

要创建能帮助您定位到多个国家/地区的新主要 Feed，请配置使用 Cloud Build PrimaryProductDataSource 请勿设置 feedLabel 和 contentLanguage 字段。

使用 Content API for Shopping 时，系统只会为您创建一个 API 数据源。使用 Merchant Data Sources API，您可以拥有多个 API 数据源，其中一些 API 数据源可以不设置 feedLabel 和 contentLanguage 字段。

只有包含 API 输入的数据源才能不包含 feedLabel 和已设置 contentLanguage 个字段。文件不支持此类型的数据源输入。

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

补充数据源仅用于更新已经存在于一个或多个主要数据源中。您可以提供多个补充数据源，且每个数据源可以补充任意个主要数据源中的数据。

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

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

补充文件数据源必须设置 feedLabel 和 contentLanguage 字段。补充 API 数据源的 feedLabel 和 contentLanguage 字段始终必须处于未设置状态。

为文件数据源设置时间表

要为文件 Feed 设置时间表，请将数据源配置为文件使用 FileInput 字段指定数据源，然后设置 fetchsettings FileInput.FetchSettings 字段。

删除数据源

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

提取数据源

如需提取在数据源中配置的文件，请使用 accounts.dataSources.fetch 方法。此方法会立即对您账号中的数据源执行数据提取。此方法仅适用于设置了文件输入的数据源。

获取数据源

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

列出数据源

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

修补数据源

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

关联数据源

借助主要商品数据源，您可以管理数据源的默认规则。默认规则是适用于属性。可在创建数据源，或通过默认规则更新现有数据源字段。

以下示例配置可确保先从具有唯一标识符 1001 的数据源中获取所有属性。然后，系统会从主要数据源添加缺失的属性。最后，如果任何其他数据源中尚未提供剩余属性，系统会从具有唯一标识符 1002 的补充数据源中获取这些属性。如果属性同时存在于多个数据源中，则列表中优先级较高的值是已选择。

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

自动管理 Feed

如需为您的账号注册自动管理数据源的功能，您必须执行以下操作：

您可以调用 accounts.autofeedSettings.getAutofeedSettings 方法。
确保您的账号不是购物平台账号。

当您的账号符合注册条件后，您就可以使用 accounts.autofeedSettings.updateAutofeedSettings 方法启用对数据源的自动管理。启用数据源自动管理功能后，Google 会自动从您的网店添加商品，并确保这些商品在 Google 平台上始终保持最新状态。

检索文件上传状态

要使用文件、提取或电子表格获取数据源的状态，您需要可以调用GET accounts.dataSources.fileUploads 服务。为了获取所计算的数据源的上次检索结果在数据源处理完成时异步执行，请使用标识符 latest。

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

文件上传状态可能包含商品的详细视图，包括任何潜在问题

请注意，如果文件从未上传，则可能不存在文件上传状态。如果在文件上传后不久收到请求，该文件可能就会处于“正在处理”状态文件即会上传。