检索汇总商品统计信息和问题的方式已发生变化。之前在 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等查询参数来选择数据，而是使用带有filter字符串的list方法来查询特定报告上下文和国家/地区。 - 渠道字段移除：
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。其中的字段名称转换为蛇形命名法，例如，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。 |