此页面介绍了如何以编程方式创建和更新 供您插入商品。自动数据 来源 将您的商品数据提供给 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
方法。
关联数据源
主要商品数据来源可让您管理默认数据源 数据源规则。默认规则是适用于 属性。可在创建 数据源，或通过默认规则更新现有数据源 字段。
以下示例配置确保先获取所有属性
从数据源检索到的（唯一标识符为 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.Get方法结合使用。 - 确保您的账号不是购物平台 账号。
当您的账号符合注册条件后，您就可以使用
Accounts.AutofeedSettings.Update 方法，用于启用数据自动管理
来源。启用数据源的自动管理设置可让 Google 自动管理数据源
从您的网店添加商品，并确保这些商品始终是最新的
在 Google 的平台上
检索文件上传状态
要使用文件、提取或电子表格获取数据源的状态，您需要
可以调用 FileUpload 服务的 GET 方法。为了获取
数据源的最后一次检索操作是异步计算的，
来源处理完成时，请使用名称标识符 latest。
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
文件上传状态可能包含商品的详细视图，包括 任何潜在问题
请注意，如果文件从未上传，则可能不存在文件上传状态。 如果在文件上传后不久收到请求，该文件可能就会处于“正在处理”状态 文件即会上传。