假设您想要获取帐号中当前可用商品的信息。特别是,您有兴趣了解您的任何产品是否存在需要解决的问题。您知道如何从 Merchant Center 获取此信息,但更希望使用 Content API 设置自动提醒系统。在本指南中,我们将介绍 Content API 中的问题严重程度信息与 Merchant Center 的“诊断”报告中显示的问题优先级之间的对应关系。
使用 Content API 的示例
如需获取影响您的商品的问题,您可以为您的帐号运行 accountstatuses.get
。以下是您获取的资源的缩减示例:
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
在 accountLevelIssues[].severity
下,您会看到 Merchant Center 帐号错误的严重程度。Critical
错误将导致帐号被暂停,进而导致您无法投放商品。
在 itemLevelIssues
下,您可以看到可能导致商品被拒批的商品错误。请注意,itemLevelIssues[].numItems
表示您的帐号中有 2 个商品受到了损坏的图片链接的影响,有 5 个商品存在着陆页错误。
在 itemLevelIssues[].servability
下,您可以看到错误是否导致受影响的商品被拒批。请注意,损坏的图片链接和着陆页错误都会导致商品被拒批。
如需查找所有受影响的商品,请调用 Productstatuses.list
以获取每个商品的问题的完整列表。它返回如下条目:
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
现在您已经了解了帐号中所有商品的问题,但尚不清楚解决这些问题的重要性。
在我们的 productstatuses
示例中,您可以使用 itemLevelIssues[].servability
了解某个错误是否导致您无法通过“在 Google 上购买”、购物广告或“Google 平台呈现”投放商品。
如果 itemLevelIssues[].servability
为 unaffected
,类似于 ambiguous_gtin
错误,则该错误不会阻止您的商品投放。
但是,如果 itemLevelIssues[].servability
与 mobile_landing_page_crawling_not_allowed
错误一样,其值为 disapproved
,则是一个更严重的错误,因为在修正错误之前无法投放商品。
在我们的 accountstatuses
示例中,Merchant Center 中的“诊断”部分的 accountLevelIssues[].severity
下定义了问题优先级以及不同优先级的确切含义。
首先,我们来看一下该报告:
您从 Content API for Shopping 获取的所有信息与您在“诊断”部分中看到的信息有何关联?哪些条目是您需要尽快解决的问题,哪些条目是很好的解决,但并非必须解决?如果不解决,哪些问题会导致您的商品无法在广告中展示?
如这些示例所示,“诊断”部分提供该账号中的帐号和商品问题的严重程度信息,而 Content API(通过 Accountstatuses
服务)仅提供 accountLevel
问题的严重程度信息。
根据问题的严重程度,每个来源将问题分为三类。了解如何判断状态相关服务返回的问题的严重程度,有助于快速确定哪些问题最需要解决,哪些问题可以放心地忽略。
问题优先级
在“诊断”部分,问题优先级将问题严重程度描述为以下三个级别之一:错误、警告和通知。在上述这类报表中,这些级别用显示在第一列中的图片表示: 表示错误, 表示警告, 表示通知。
错误导致了帐号中止或商品被拒批。您应尽快解决这些错误,以确保商品可以重新显示在搜索结果中。
警告可能会对您的广告效果产生不利影响,并且除非问题得到解决,否则日后可能会导致商品暂停展示或帐号被暂停。
通知是有助于提高数据质量的建议优化措施。我们建议您解决这些问题,但这并非强制要求。
不过,我们无需访问 Merchant Center 去找出错误。
在 Content API 中,accountstatuses
资源对象中的 accountLevelIssues[].severity
字段提供相同的问题严重级别信息。这些字段可以包含下列三个值之一:critical
、error
和 suggestion
。
这些值与“诊断”标签页上的问题优先级一一对应:
数据质量问题严重性 (API) | 问题优先级 |
---|---|
critical |
错误 () |
error |
警告 () |
suggestion |
通知 () |
因此,在我们的 accountstatuses
示例中,missing_ad_words_link
问题可让您知道需要关联 Google Ads 帐号才能投放广告,但这不会影响商品在您的 Merchant Center 数据库中获得批准。另一方面,editorial_and_professional_standards_destination_url_down_policy
是一个更严重的错误,会导致您的帐号被暂停。如果您参与了“在 Google 上购买”和“Google 跨平台呈现”计划,或者您有关联的 Google Ads 帐号,critical
错误会立即阻止您的商品在“在 Google 上购买”“Google 平台呈现”和购物广告计划中投放广告。
掌握了这些信息后,您现在可以编写提醒软件,立即提醒您注意重要问题,同时收集不太严重的问题以供最终修复,而无需访问 Merchant Center 来区分问题。