将 accountstatuses 迁移到汇总商品状态

您检索汇总商品统计信息和问题的方式已发生变化。之前在 Content API for Shopping 的 accountstatuses 资源中提供的功能现在已拆分为 Merchant API 中的专用资源。本指南介绍了如何迁移集成以使用新的 aggregateProductStatuses 资源。

注意：在 Merchant API 中，账号级问题和汇总商品状态是分开的。另请参阅我们的指南，了解如何从 accountstatuses 迁移到账号问题。

主要差异

以下是 Content API for Shopping 和 Merchant API 中商品状态功能的主要区别：

• 专用资源：Content API for Shopping 中的 accountstatuses 资源现已拆分。在 Merchant API 中，您可以通过 accountissues 资源获取账号级问题，而通过新的 aggregateProductStatuses 资源获取汇总的商品统计信息和商品级问题。
• 新资源结构：AggregateProductStatus 是一种新资源，用于表示报告上下文和国家/地区的特定组合的统计信息和问题。
• 过滤机制：Merchant API 不使用 destinations 等查询参数来选择数据，而是使用 list 方法和 filter 字符串来查询特定报告背景信息和国家/地区。
• 移除渠道字段：不再使用 channel 字段。此信息现在隐式包含在 reportingContext 中。

请求

Merchant API 使用包含 filter 参数的 GET 请求来检索汇总的商品状态。

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

请求网址格式

请求说明	Content API for Shopping	Merchant API
获取商品统计信息和问题	GET /content/v2.1/{merchantId}/accountstatuses/{accountId}	GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

标识符

资源标识方式已更改，以支持新结构。

标识符格式

标识符说明	Content API for Shopping	Merchant API
资源标识符	资源由 accountId 标识。使用查询参数选择了特定的数据切片。	资源名称可唯一标识特定报告背景信息和国家/地区的数据：accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}。

方法

用于检索商品状态的方法已更新为支持过滤的 list 方法。

Content API for Shopping 方法	Merchant API 方法	适用范围和备注
accountstatuses.get	aggregateProductStatuses.list	accountstatuses.get 方法返回了一个包含所有商品统计信息的资源。新的 aggregateProductStatuses.list 方法会返回一个资源列表，其中包含每个报告情境和国家/地区组合对应的资源。使用 filter 参数检索特定数据。对于账号级问题，请使用 accountissues.list。

详细的字段更改

新 AggregateProductStatus 资源中已更新并重新构建了商品统计信息和问题对应的字段。

Content API for Shopping	Merchant API	说明
products	aggregate_product_statuses	列表响应中的 products 数组已替换为 aggregate_product_statuses 重复字段。
destination	reporting_context	destination 字段已替换为 reporting_context，后者用于指定统计信息的程序上下文。
channel	（无等效字段）	移除了 channel 字段。此信息现在是 reporting_context 的一部分。
statistics	stats	statistics 对象已重命名为 stats。其中的字段名称会转换为 snake_case，例如，activeCount 现在为 active_count。
itemLevelIssues.servability	item_level_issues.severity	servability 枚举已替换为 severity 枚举，用于描述问题的影响。
itemLevelIssues.attributeName	item_level_issues.attribute	已将字段 attributeName 重命名为 attribute。
itemLevelIssues.documentation	item_level_issues.documentation_uri	已将字段 documentation 重命名为 documentation_uri。
itemLevelIssues.numItems	item_level_issues.product_count	已将字段 numItems 重命名为 product_count。