从 accountstatuses 迁移到“账号问题”

我们更改了检索可能会影响商品和账号健康状况的账号级问题的方式。与 Content API for Shopping 中的 accountstatuses 资源相比，Merchant API 引入了专用 AccountIssue 资源，可提供更结构化和更详细的信息。

如需详细了解如何使用此新功能，请参阅查看账号问题指南。

主要差异

以下是 Merchant API AccountIssue 资源中的主要改进和差异：

• 专用资源：账号问题是其自身的资源。在 Content API for Shopping 中，账号级问题是常规 AccountStatus 资源中的一个嵌套字段。借助 Merchant API，您可以使用 accounts.issues.list 方法直接列出这些商品。
• 结构化影响数据：AccountIssue 资源提供详细的 impactedDestinations 字段。此字段可清晰显示问题的具体影响，包括目标平台（例如购物广告）、特定地区以及该地区的问题严重程度。
• 严重程度（以枚举形式表示）：severity 字段现在是一个枚举（具有 CRITICAL、ERROR、SUGGESTION 等值），与 Google 购物广告内容 API 中基于字符串的值相比，更易于以程序化方式处理。
• 标准化标识符：每个账号问题都有一个唯一的完整资源 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/v1beta/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/v1beta/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。