問題の重大度と Merchant Center の診断
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アカウントで現在利用可能な商品に関する情報を取得するとします。特に、対処が必要な問題が製品にないかどうかを知りたいと考えています。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 が 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 の問題に関する重大度情報のみが表示されます。
各ソースでは、問題の重大度に基づいて問題が 3 つのカテゴリに分類されます。ステータス関連サービスから返された問題の重大度を判断する方法を理解すると、どの問題に優先的に対処すべきか、どの問題は無視してもよいかを迅速に特定できます。
問題の優先順位付け
[診断] セクションでは、問題の優先順位は、エラー、警告、通知の 3 つのレベルで問題の重大度を表します。上記のレポート テーブルでは、これらのレベルは最初の列に表示される画像で表されます。エラーの場合は 
、警告の場合は 
、通知の場合は 
です。
エラーが原因で、アカウントの停止または商品アイテムの不承認が発生しました。商品アイテムが再び検索結果に表示されるようにするために、できるだけ早く解決する必要があります。
警告は、広告の掲載結果にマイナスの影響を与える可能性があり、この問題を解決しないと、商品アイテムまたはアカウントが強制停止される可能性があります。
通知は、データ品質を高めるための最適化案です。これらの問題を解決することをおすすめしますが、必須ではありません。
ただし、どのエラーがどれであるかを確認するために Merchant Center にアクセスする必要はありません。Content API では、accountstatuses リソース オブジェクトの accountLevelIssues[].severity フィールドで同じ問題の重大度情報が提供されます。これらのフィールドには、critical、error、suggestion の 3 つの値のいずれかを指定できます。
これらの値は、[診断] タブの問題の優先順位と 1 対 1 で対応しています。
| データ品質の問題の重大度（API） |
問題の優先順位付け |
critical |
エラー（） |
error |
警告（） |
suggestion |
通知（） |
accountstatuses の例では、missing_ad_words_link の問題は、広告を配信するために Google 広告アカウントをリンクする必要があることを示していますが、Merchant Center データベースでの商品の承認には影響しません。一方、editorial_and_professional_standards_destination_url_down_policy はアカウントが停止されるより重大なエラーです。Google で購入、Google のさまざまなサービス、またはリンクされた Google 広告アカウントに参加している場合、critical エラーが発生すると、Google で購入、Google のさまざまなサービス、ショッピング広告プログラムで商品がすぐに配信されなくなります。
この情報に基づいて、重要な問題をすぐに通知し、重要度の低い問題を収集して最終的に修正するアラート ソフトウェアを作成できます。Merchant Center にアクセスしてどちらの問題であるかを判断する必要はありません。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-13 UTC。
[null,null,["最終更新日 2025-08-13 UTC。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and offers improved integration capabilities.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eaccountstatuses.get\u003c/code\u003e and \u003ccode\u003eproductstatuses.list\u003c/code\u003e to retrieve account and product-level issue data respectively.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eaccountLevelIssues[].severity\u003c/code\u003e and \u003ccode\u003eitemLevelIssues[].servability\u003c/code\u003e fields indicate the severity of issues, ranging from critical errors to mere suggestions.\u003c/p\u003e\n"],["\u003cp\u003eIssue severity in the API corresponds to the Diagnostics section in Merchant Center, aiding in prioritization of fixes.\u003c/p\u003e\n"],["\u003cp\u003eCritical errors (\u003ccode\u003ecritical\u003c/code\u003e severity) result in account suspension and require immediate attention to resume product serving.\u003c/p\u003e\n"]]],["The core content explains how to use the Content API to identify and prioritize issues affecting products and accounts. It uses `accountstatuses.get` and `Productstatuses.list` to retrieve issues. Account-level issues have severities: `critical` (account suspension), `error` (future issues), and `suggestion` (optimizations). Item-level issues indicate if products are `disapproved` or `unaffected`, which corresponds to issues that stop the product from being available. These severities in the API directly correlate with the error, warning, and notification system in the Merchant Center's Diagnostics section.\n"],null,["# Issue severity and Merchant Center Diagnostics\n\nSuppose you want to get information on the products currently available in your\naccount. In particular, you're interested in knowing whether any of your\nproducts have issues that need addressing. You know how to get this information\nfrom the Merchant Center, but you'd rather set up an automatic alerting system\nusing the Content API. In this guide, we'll go through how the issue severity\ninformation in the Content API maps to the issue prioritization seen in the\nDiagnostics reports in the Merchant Center.\n\nExample with Content API\n------------------------\n\nTo get the issues affecting your products, you can run\n[`accountstatuses.get`](/shopping-content/reference/rest/v2.1/accountstatuses/get)\nfor your account. Here's a cut down example of the resource you get back: \n\n {\n \"kind\": \"content#accountStatus\",\n \"accountId\": \"...\",\n \"accountLevelIssues\": [\n {\n \"id\": \"editorial_and_professional_standards_destination_url_down_policy\",\n \"title\": \"Account suspended due to policy violation: landing page not working\",\n \"country\": \"US\",\n \"severity\": \"critical\",\n \"documentation\": \"https://support.google.com/merchants/answer/6150244#wycd-usefulness\"\n },\n {\n \"id\": \"missing_ad_words_link\",\n \"title\": \"No Google Ads account linked\",\n \"severity\": \"error\",\n \"documentation\": \"https://support.google.com/merchants/answer/6159060\"\n }\n ],\n \"products\": [\n {\n \"channel\": \"online\",\n \"destination\": \"Shopping\",\n \"country\": \"US\",\n \"statistics\": {\n \"active\": \"0\",\n \"pending\": \"0\",\n \"disapproved\": \"5\",\n \"expiring\": \"0\"\n },\n \"itemLevelIssues\": [\n {\n \"code\": \"image_link_broken\",\n \"servability\": \"disapproved\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"image link\",\n \"description\": \"Invalid image [image link]\",\n \"detail\": \"Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)\",\n \"documentation\": \"https://support.google.com/merchants/answer/6098289\",\n \"numItems\": \"2\"\n },\n {\n \"code\": \"landing_page_error\",\n \"servability\": \"disapproved\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"link\",\n \"description\": \"Unavailable desktop landing page\",\n \"detail\": \"Update your website or landing page URL to enable access from desktop devices\",\n \"documentation\": \"https://support.google.com/merchants/answer/6098155\",\n \"numItems\": \"5\"\n }\n ]\n },\n ...\n }\n\nUnder `accountLevelIssues[].severity`, you see the severity of Merchant Center\naccount errors. `Critical` errors will cause an account suspension, which will\nstop you from serving your products.\n\nUnder `itemLevelIssues`, you can see the product errors that can lead to product\ndisapprovals. Note that `itemLevelIssues[].numItems` lets you know that 2 items\nin your account are affected by a broken image link, and 5 items have a\nlanding page error.\n\nUnder `itemLevelIssues[].servability`, you can see whether the error causes the\naffected products to be disapproved. Note that both the broken image link and\nthe landing page error cause products to be disapproved.\n\nTo find all the affected products, you call\n[`Productstatuses.list`](/shopping-content/reference/rest/v2.1/productstatuses/list)\nto get a complete list of issues on a per-product basis. It returns\nentries like the following: \n\n {\n \"kind\": \"content#productstatusesListResponse\",\n ...\n \"resources\": [\n {\n \"kind\": \"content#productStatus\",\n \"productId\": \"online:en:US:online-en-US-GGL614\",\n ...\n \"itemLevelIssues\": [\n {\n \"code\": \"mobile_landing_page_crawling_not_allowed\",\n \"servability\": \"disapproved\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"link\",\n \"destination\": \"Shopping\",\n \"description\": \"Mobile page not crawlable due to robots.txt\",\n \"detail\": \"Update your robots.txt file to allow user-agents \\\"Googlebot\\\" and \\\"Googlebot-Image\\\" to crawl your site\",\n \"documentation\": \"https://support.google.com/merchants/answer/6098296\"\n },\n {\n \"code\": \"pending_initial_policy_review\",\n \"servability\": \"disapproved\",\n \"resolution\": \"pending_processing\",\n \"destination\": \"Shopping\",\n \"description\": \"Pending initial review\",\n \"documentation\": \"https://support.google.com/merchants/answer/2948694\"\n },\n {\n \"code\": \"ambiguous_gtin\",\n \"servability\": \"unaffected\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"gtin\",\n \"destination\": \"Shopping\",\n \"description\": \"Ambiguous value [gtin]\",\n \"detail\": \"Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.\",\n \"documentation\": \"https://support.google.com/merchants/answer/7000891\"\n }\n ],\n ...\n },\n ...\n ]\n }\n\nNow you have information about the issues for all the products in your account,\nbut it's unclear how important it is to fix these issues.\n\nIn our `productstatuses` example, you can use `itemLevelIssues[].servability`\nto discover whether an error disables your ability to serve the product in\nBuy on Google, Shopping Ads, or Surfaces across Google.\n\nIf `itemLevelIssues[].servability` is `unaffected` like the\n`ambiguous_gtin` error, the error will not prevent your product from\nserving.\n\nHowever, if `itemLevelIssues[].servability` is `disapproved` like the\n`mobile_landing_page_crawling_not_allowed` error, this is a much more\nserious error since you cannot serve your product until the error is fixed.\n\nIn our `accountstatuses` example, under `accountLevelIssues[].severity`, the\n[Diagnostics section](https://support.google.com/merchants/answer/1680021)\nin [Merchant Center](https://merchants.google.com/) defines issue prioritization\nand precisely what the different priorities mean.\n\nFirst, take a look at the report:\n\nHow does all the information you're getting from\nthe Content API for Shopping correlate with what you see\nin the Diagnostics section? Which entries are issues you need to fix ASAP, and\nwhich ones would be nice to tackle, but are not essential to fix? Which issues\nwill stop your products from serving in your ads if unaddressed?\n\nAs shown in these examples, the Diagnostics section provides severity information\nabout issues for the account and products on that account, while the Content API\n(via the `Accountstatuses` service) provides severity information\nsolely for `accountLevel` issues.\n\nEach source divides issues into three categories based\non the severity of the issue. Understanding how to judge the severity of issues\nreturned from the status-related services can help quickly pinpoint which issues\nare the most important to address, and which issues can be safely ignored.\n\nIssue prioritization\n--------------------\n\nIn the Diagnostics section, the issue prioritization describes the issue\nseverity as one of three levels: errors, warnings, and notifications. In\nreport tables like the one above, these levels are represented by images that\nappear in the first\ncolumn:\nfor\nerrors,\nfor\nwarnings,\nand\nfor notifications.\n\n- Errors have caused either an account suspension or an item disapproval. They\n should be resolved as soon as possible to ensure items are eligible to appear\n in results again.\n\n- Warnings could negatively impact the performance of your ads and will likely\n lead to item or account suspensions in the future unless the issue is\n resolved.\n\n- Notifications are suggested optimizations to increase data quality. Resolving\n these issues is recommended, but not required.\n\nWe need not visit Merchant Center to find out which errors are which, though.\nIn the Content API, the `accountLevelIssues[].severity` field in the\n`accountstatuses` resource objects provides the same\nissue severity information. These fields can contain one of three values:\n`critical`, `error`, and `suggestion`.\n\nThese values have a one-to-one correspondence with the issue prioritization\non the Diagnostics tab:\n\n| Data Quality Issue Severity (API) | Issue Prioritization |\n|-----------------------------------|----------------------|\n| `critical` | Error () |\n| `error` | Warning () |\n| `suggestion` | Notification () |\n\nSo in our `accountstatuses` example, the `missing_ad_words_link` issue lets you\nknow that you need to link a Google Ads account to serve ads, but it won't\naffect the product's approval in your Merchant Center database.\nOn the other hand, the\n`editorial_and_professional_standards_destination_url_down_policy` is a\nmore severe error that suspends your account. If you are participating\nin Buy on Google, Surfaces across Google, or if you had a linked Google Ads\naccount, a `critical` error stops your products from serving in the\nBuy on Google, Surfaces across Google, and Shopping Ads programs immediately.\n\nArmed with this information, you can now write alerting software that will\nbring important issues to your attention immediately while collecting less\nserious issues for eventual fixing, without having to visit Merchant Center to\ndiscern which is which."]]
