检索可能会影响您的商品和账号健康度的账号级问题的方式已发生变化。与 Content API for Shopping 中的 accountstatuses 资源相比，Merchant API 引入了专用的 AccountIssue 资源，可提供更结构化和更详细的信息。
如需详细了解如何使用这项新功能，请参阅查看账号问题 指南。
注意：在 Merchant API 中，账号级问题和汇总商品状态
是分开的。另请参阅我们的指南，了解如何从 accountstatuses 迁移到
汇总商品状态。
主要区别
以下是 Merchant API AccountIssue 资源的主要改进和区别：
- 专用资源 ：账号问题是其自己的资源。在 Content API for Shopping 中，账号级问题是常规
AccountStatus资源中的嵌套字段。借助 Merchant API，您可以使用accounts.issues.list方法直接列出这些问题。 - 结构化影响数据 ：
AccountIssue资源提供了一个详细的impactedDestinations字段。此字段可让您清楚地了解问题的影响，包括目标平台（例如购物广告）、具体区域以及该区域中问题的严重程度。 - 严重程度作为枚举 ：
severity字段现在是一个枚举（具有CRITICAL、ERROR、SUGGESTION等值），与 Content API for Shopping 中基于字符串的值相比，可以更轻松地以编程方式进行处理。 - 标准化标识符 ：每个账号问题都有一个唯一的完整资源
name，格式为accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}。这种标准化方法取代了 Content API for Shopping 中的id字符串。 - 本地化支持 ：借助
accounts.issues.list方法，您可以指定language_code，以您偏好的语言接收问题详情，例如标题和说明。这在 Content API for Shopping 中是不可能的。 - 高级账号行为 ：当您对高级账号调用
accounts.issues.list时，它只会返回直接适用于该高级账号的问题，而不会返回其任何子账号的问题。在 Content API for Shopping 中，accountstatuses.list方法会返回所有子账号的状态。如需在 Merchant API 中获取所有子账号的问题，您必须先调用accounts.listSubaccounts，然后单独为每个子账号调用accounts.issues.list。
请求
在 Merchant API 中，您可以列出特定 Merchant Center 账号的账号问题。
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
请求网址比较
| 请求说明 | Content API for Shopping | Merchant API |
|---|---|---|
| 列出单个账号的账号级问题 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} |
GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues |
| 列出高级账号的所有子账号的账号级问题 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses |
无法使用。您必须遍历子账号。 |
标识符
在 Merchant API 中，账号和问题的标识符已发生变化。
标识符比较
| 标识符说明 | Content API for Shopping | Merchant API |
|---|---|---|
| 账号标识符 | {MERCHANT_ID} 和 {ACCOUNT_ID} 作为路径参数。 |
{ACCOUNT_ID} 作为路径参数，格式为 accounts/{ACCOUNT_ID}。 |
| 问题标识符 | 响应正文中的 id 字段（例如 "products-that-enable-dishonest-behavior-hacking-policy"）。 |
响应正文中的 name 字段，即完整资源名称（例如 accounts/12345/issues/example-issue-id）。 |
方法
在 Merchant API 中，用于检索账号问题的方法已得到整合和简化。
方法比较
| Content API for Shopping | Merchant API | 适用范围和说明 |
|---|---|---|
accountstatuses.get |
accounts.issues.list |
可用 。如需获取单个账号的问题，请使用 accounts.issues.list 并指定账号 ID。Merchant API 没有用于单个问题的 get 方法。 |
accountstatuses.list |
无直接对等项。 | 无法使用 。Merchant API 中的 accounts.issues.list 方法仅返回指定账号的问题，而不返回其子账号的问题。如需获取所有子账号的问题，您必须先调用 accounts.listSubaccounts，然后为每个子账号调用 accounts.issues.list。 |
accountstatuses.custombatch |
无直接对等项。 | 无法使用 。Merchant API 不支持对账号问题进行批量处理。您必须为每个账号单独进行 list 调用。 |
字段详细更改
账号问题资源中的字段已更新，以提供更结构化和更清晰的信息。
字段比较
| Content API for Shopping | Merchant API | 说明 |
|---|---|---|
accountLevelIssues（AccountStatus 中的数组） |
accountIssues（ListAccountIssuesResponse 中的数组） |
问题现在是专用的顶级资源，而不是嵌套字段。 |
id（字符串） |
name（字符串） |
问题标识符现在是完整资源名称，例如 accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}。 |
title（字符串） |
title（字符串） |
没有变化。 |
detail（字符串） |
detail（字符串） |
没有变化。 |
documentation（字符串） |
documentationUri（字符串） |
为了清晰起见，字段已重命名，以表明它是网址。 |
severity（字符串） |
severity（枚举） |
严重程度现在是结构化枚举（CRITICAL、ERROR、SUGGESTION），而不是字符串。 |
country（字符串）、destination（字符串） |
impactedDestinations（重复消息） |
影响现在以列表的形式结构化，将每个受影响区域的目标平台、区域和严重程度分组。country 字段已替换为 Impact 消息中的 regionCode。 |
| （不可用） | language_code、time_zone（请求参数） |
list 请求中的新参数允许对 title 和 detail 等人类可读字段进行本地化。 |