アカウントで現在利用可能な商品に関する情報を取得したいとします。特に、対処が必要な問題が商品にないかどうかを知りたいと考えています。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 全体のサーフェスで商品を掲載できなくなるかどうかを確認できます。
ambiguous_gtin エラーのように itemLevelIssues[].servability が unaffected
の場合、エラーによって商品の掲載が妨げられることはありません。
ただし、mobile_landing_page_crawling_not_allowed エラーのように
itemLevelIssues[].servability が disapproved
の場合、エラーが修正されるまで商品を掲載できないため、はるかに深刻なエラーとなります。
accountstatuses の例では、accountLevelIssues[].severity の下にある
[診断]
セクションで、Merchant Center の問題の優先順位と、優先順位の意味が定義されています。
まず、レポートを見てみましょう。
Shopping Content API から取得したすべての情報は、[診断] セクションに表示される情報とどのように関連していますか。 すぐに修正する必要がある問題はどれですか。修正できればよいが、修正が必須ではない問題はどれですか。 対処しないと広告で商品の掲載が停止する問題はどれですか。
これらの例に示すように、[診断] セクションには、アカウントとアカウント内の商品の問題に関する重大度情報が表示されますが、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 にアクセスして区別しなくても、重要な問題にすぐに注意を向け、深刻度の低い問題を収集して最終的に修正するアラート ソフトウェアを作成できます。