假設您想要取得帳戶中目前可用產品的資訊，您尤其想知道自家產品是否存在需要處理的問題。您知道如何從 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 瞭解錯誤是否導致您無法在 Buy on Google、購物廣告或 Google 跨平台顯示產品。
如果 itemLevelIssues[].servability 與 ambiguous_gtin 錯誤類似 unaffected，錯誤就不會妨礙產品放送。
不過，如果 itemLevelIssues[].servability 是 disapproved 和 mobile_landing_page_crawling_not_allowed 錯誤，則會是更加嚴重的錯誤，因為要等到錯誤修正才能提供產品。
在 accountstatuses 範例中，accountLevelIssues[].severity 的 Merchant Center 的診斷專區會定義問題優先順序，並精確地指出不同優先順序的意義。
首先，請查看報表：
您從 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 則是將帳戶停權的嚴重錯誤。如果您已採用 Buy on Google、Google 跨平台顯示或已連結 Google Ads 帳戶，critical就會發生錯誤，導致產品立即停止在 Buy on Google、Google 跨平台顯示和購物廣告計畫中顯示。
掌握這些資訊後，您現在可以編寫快訊軟體，立即產生重要問題，並收集較不嚴重的問題以進行最終修正，而不必前往 Merchant Center 確認。