本指南介绍了如何将集成从 Content API for Shopping 的 datafeeds
和 datafeedstatuses
服务迁移到 Merchant API 中的“数据源”子 API。新的 Data sources 子 API 可让您更直接地控制数据流水线,并简化数据源管理。
如需详细了解新功能,请参阅管理数据源指南。
主要差异
与 Content API for Shopping 相比,Merchant API 具有多项优势。
显式数据源创建。该 API 不再在您首次插入商品时自动创建“Content API”数据源。在 Merchant API 中,您需要先明确创建数据源,然后才能向其中上传商品。 这样,您从一开始就可以更好地控制产品数据流水线的组织和管理。
支持多个 API 数据源。在 Content API for Shopping 中,您只能使用一个自动创建的“Content API”数据源。借助 Merchant API,您可以创建和管理多个
API
输入类型的数据源。没有标签和语言的数据源。借助 Merchant API,您可以创建主数据源,而无需指定
feedLabel
和contentLanguage
。此类数据源接受以任意组合形式提供的feedLabel
和contentLanguage
商品,从而简化了不需要为不同地区单独提供数据源的集成方案的商品上传流程。简化了数据目标。每个数据源现在都对应一个目标,该目标由
feedLabel
和contentLanguage
的唯一组合定义。Merchant API 中已弃用多数据定位 Feed。专用文件上传状态。Merchant API 使用单独的只读
fileUploads
资源来表示基于文件的数据源的状态。如需检索文件上传的状态,请使用带有latest
别名的fileUploads.get
方法。新的数据源类型。
DataSource
资源支持更多垂直行业,包括促销、本地商品目录和区域商品目录,从而提供一种统一的方式来管理所有数据流水线。自动化数据源。借助 Merchant API,您现在可以使用 Accounts 子 API 中的
autofeedSettings.updateAutofeedSettings
方法为账号启用或停用自动数据源功能。如需了解详情,请参阅配置自动进纸设置。
请求
下表比较了 Content API for Shopping 和 Merchant API 之间的请求网址格式。
请求说明 | Content API for Shopping | Merchant API |
---|---|---|
创建数据源 | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds |
POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources |
获取数据源 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
列出数据源 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources |
更新数据源 | PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
删除数据源 | DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
提取数据源 | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow |
POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch |
获取数据源状态 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID} |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest |
列出数据源状态 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses |
无法使用。为每个基于文件的数据源使用 dataSources.list 和 fileUploads.get 。 |
标识符
Merchant API 使用基于字符串的资源名称作为标识符。
标识符说明 | Content API for Shopping | Merchant API |
---|---|---|
数据源标识符 | datafeedId (数字) |
name (字符串,格式:accounts/{account}/dataSources/{datasource} ) |
方法
下表将 Content API for Shopping datafeeds
和 datafeedstatuses
服务中的方法与 Merchant API 中的等效方法进行了比较。
Content API for Shopping 方法 | Merchant API 方法 | 适用范围和备注 |
---|---|---|
datafeeds.custombatch |
不可用 | 请改用单独的 API 调用。 |
datafeeds.delete |
dataSources.delete |
可用。 |
datafeeds.fetchnow |
dataSources.fetch |
可用。此方法现在仅适用于具有文件输入的数据源。 |
datafeeds.get |
dataSources.get |
可用。 |
datafeeds.insert |
dataSources.create |
可用。 |
datafeeds.list |
dataSources.list |
可用。 |
datafeeds.update |
dataSources.update |
可用。使用 PATCH 语义,而不是 PUT 。 |
datafeedstatuses.custombatch |
不可用 | 请改用单独的 API 调用。如需了解详情,请参阅一次发送多项请求。 |
datafeedstatuses.get |
fileUploads.get |
适用于基于文件的数据源。使用 latest 别名可获取最近一次上传的状态。对于其他数据源类型,状态信息是 DataSource 资源的一部分。 |
datafeedstatuses.list |
不可用 | 如需获取多个数据源的状态,请先列出所有包含 dataSources.list 的数据源。然后,使用每个基于文件的数据源的 latest 别名调用 fileUploads.get 。 |
详细的字段更改
此表显示了 Content API for Shopping 中的 Datafeed
和 DatafeedStatus
资源与 Merchant API 中的 DataSource
和 FileUpload
资源之间的字段级变化。
Content API for Shopping | Merchant API | 说明 |
---|---|---|
Datafeed |
DataSource |
数据源配置的主要资源。 |
id |
name |
资源标识符。从数字 ID 更改为字符串资源名称。 |
name |
displayName |
数据源面向用户的名称。 |
attributeLanguage |
primaryProductDataSource.contentLanguage |
数据源中商品的双字母 ISO 639-1 语言代码。 |
fileName |
fileInput.fileName |
已上传文件的名称。此字段现在嵌套在 fileInput 下。 |
fetchSchedule |
fileInput.fetchSettings |
用于提取基于文件的数据源的时间表。现在,此属性嵌套在 fileInput 下。 |
fetchSchedule.paused |
fileInput.fetchSettings.enabled |
逻辑已反转。paused: true 等效于 enabled: false 。 |
format |
不可用 | 系统会移除 fileEncoding 、columnDelimiter 和 quotingMode 字段。现在,系统会自动检测这些参数。 |
targets |
primaryProductDataSource.feedLabel 、primaryProductDataSource.contentLanguage 、primaryProductDataSource.countries |
移除了重复的 targets 字段。每个数据源现在都有一个由这些字段定义的目标,这反映了多数据目标 Feed 的弃用。 |
DatafeedStatus |
FileUpload |
文件上传状态现在是一个单独的只读资源。 |
datafeedId |
name |
文件上传的标识符,用于引用其父数据源。 |
processingStatus |
processingState |
上传的处理状态。字符串值(success 、failure 、in progress )替换为枚举(SUCCEEDED 、FAILED 、IN_PROGRESS )。 |
errors 、warnings |
issues |
错误和警告会合并到单个 issues 列表中。每个问题都有一个 severity 字段(ERROR 或 WARNING )。 |
lastUploadDate |
uploadTime |
上次上传的时间戳。格式已从字符串更改为 Timestamp 对象。 |
country 、language 、feedLabel |
不适用 | 这些字段已不再位于状态资源中。它们是 DataSource 资源的一部分。 |
targets[].included_destinations 、targets[].excluded_destinations |
primaryProductDataSource.destinations |
用于包含和排除目的地的两个单独列表已替换为一个 destinations 列表。新列表中的每个项都是一个对象,用于指定目的地及其状态(ENABLED 或 DISABLED ),从而提供更明确的配置。 |