假設您想要取得帳戶中目前可用產品的資訊。尤其是您會想知道自家產品是否有任何問題需要解決。您瞭解如何從 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 是 unaffected 等 ambiguous_gtin 錯誤，這項錯誤並不會導致產品無法放送。
不過，如果 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 辨識。