将 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