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(通过 AccountstatusesProductstatuses 服务)都提供此帐号中商品问题的信息。根据问题的严重性,每个来源将问题分为三类。了解状态相关服务所返回的问题严重性的判断方法,有助于判断哪些问题是最重要的并且亟待解决的,哪些问题可以放心地忽略。

问题优先级和问题严重性

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

  • 错误会导致帐号暂停或商品被拒批。您应该尽快解决这些问题,以确保商品可以再次展示在结果中。

  • 警告可能会对广告的效果产生负面影响,除非问题得到解决,否则将来可能导致商品或帐号暂停。

  • 通知是优化建议,用以提高数据质量。我们只是建议您解决这些问题,并不是强制性要求。

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

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

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

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

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