API 问题严重性和诊断问题优先级

假设您想获取您的帐号中当前可用商品的信息。特别是，您有兴趣了解您的任何商品是否存在需要解决的问题。您知道如何从 Merchant Center 获取此信息，但您更愿意使用 Content API 设置自动警报系统。在本指南中，我们将介绍 Content API 中的问题严重性信息如何映射到 Merchant Center 中诊断报告中显示的问题优先级。

与 Content API 的示例交互

要获取影响您的商品的问题，您可以为您的帐号运行 Accountstatuses.get。以下是您恢复的资源的减少示例：

{
 "accountId": "...",
 "dataQualityIssues": [
  {
   "id": "description_short",
   "severity": "suggestion",
   "numItems": 5,
   "exampleItems": [ ...5 items... ],
   ...
  },
  {
   "id": "image_link_broken",
   "severity": "critical",
   "numItems": 47,
   "exampleItems": [ ...25 items... ],
   ...
  },
  ...
}

对于 description_short，您可以看到帐号中的 5 件商品受到影响，并且提供了 5 件示例商品。这意味着全部受影响的商品都出现此问题，不需要更深入探究了。查看 image_link_broken，您可以看到有 47 件商品受到影响。但是，只提供了 25 个示例。这意味着帐号中有其他商品也受到此问题影响。

要查找受影响的所有商品，请调用 Productstatuses.list 以获取每件商品的完整问题列表。它返回如下条目：

{
 "productId": "online:en:US:book#14774266264",
  ...
  "dataQualityIssues": [
   {
    "id": "missing_condition_microdata",
    "severity": "suggestion",
    "timestamp": "2016-10-28T00:55:19Z"
   },
   ...
   {
    "id": "auth/frontend/not_claimed",
    "severity": "error",
    "location": "",
    "detail": "Website URL not claimed"
   }
  ],
 ...
}

现在您掌握了有关帐号中所有商品问题的信息，但目前尚不清楚解决这些问题的重要性。Merchant Center 中的“诊断”部分定义了问题优先级以及不同优先级的确切含义，因此请您查看此报告：

从 Merchant Center 获得的诊断报告

您从 Content API for Shopping 获取的所有信息与您在“诊断”部分中看到的信息有何关联？哪些条目是您需要尽快解决的问题，哪些条目是可以轻松处理，但是不需要解决的？如果没有解决问题，哪些问题会阻止您的商品投放到广告中？

如以上示例所示，“诊断”部分和 Content API（通过 Accountstatuses 和 Productstatuses 服务）都提供此帐号中商品问题的信息。根据问题的严重性，每个来源将问题分为三类。了解状态相关服务所返回的问题严重性的判断方法，有助于判断哪些问题是最重要的并且亟待解决的，哪些问题可以放心地忽略。

问题优先级和问题严重性

在“诊断”部分中，问题优先级将问题严重性描述为以下三个级别之一：错误、警告和通知。在上述这类报表中，这些级别用显示在第一列的图片表示：代表错误、代表警告、代表通知。

错误会导致帐号暂停或商品被拒批。您应该尽快解决这些问题，以确保商品可以再次展示在结果中。
警告可能会对广告的效果产生负面影响，除非问题得到解决，否则将来可能导致商品或帐号暂停。
通知是优化建议，用以提高数据质量。我们只是建议您解决这些问题，并不是强制性要求。

但是，我们无需访问 Merchant Center 即可找出各种错误。在 Content API 中，Accountstatuses 和 Productstatuses 资源对象中的 dataQualityIssues[].severity 字段提供相同的问题严重性信息。这些字段可以包含下列三个值之一：critical、error 和 suggestion。

这些值与“诊断”标签页上的问题优先级一一对应：

数据质量问题严重性 (API)	问题优先级
`critical`	错误 ()
`error`	警告 ()
`suggestion`	通知 ()

因此，在我们的 Accountstatuses 示例中，通过 description_short 问题，您可以了解自己是否可以为商品提供更好的描述，而不会影响商品投放获得批准。另一方面，image_link_broken 是严重得多的问题，将立即停止商品投放到广告中。同样，在我们的 Productstatuses 示例中，如果您想将微数据添加到商品页面中，各种微数据相关的问题（如 missing_condition_microdata）都是可以忽略的建议。但如果 auth/frontend/not_claimed 问题没有快速解决，则会导致商品被拒批。

利用这些信息，您现在可以编写警报软件了，该软件会使您立刻注意到重要的问题，同时收集不太严重的问题以便最终解决，而不必访问 Merchant Center 来甄别各种问题。