从 accountstatuses 迁移到“账号问题”

检索可能影响商品和账号健康状况的账号级问题的方式已发生变化。与 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）进行本地化。