ショッピング商品の詳細なステータスは productstatuses リソースで確認できます。
一般的な問題について詳しくは、プロダクトの問題をご覧ください。
販売者は、ショッピング広告と無料リスティングに関するポリシーに準拠する責任を負います。Google ショッピングは、これらのポリシーを適用し、ポリシーに違反するコンテンツや行為が見つかった場合に適切に対応する権限を有します。
要件
商品ステータスを確認するには、次の操作を行う必要があります。
- 移行先でアカウントを登録します。
- 次のいずれかの有効な国コードを指定します。
feedLabelフィールド。shippingフィールド。- フィードレベル。
- アカウントの配送設定。
商品のステータスを取得する
商品のステータスを表示するには、productstatuses.get を使用します。
get リクエストと list リクエストで destinations パラメータを使用すると、特定のデスティネーションの問題を表示できます。送信先を指定しない場合、対象となるすべての送信先からの問題が返されます。
以下に、オプションのクエリ パラメータを含む get リクエストの例を示します。
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle
productstatuses.get からのレスポンスにはすべて、次のフィールドが含まれます。
kind: 値は常にcontent#productStatusです。creationDate: 商品が作成された日付。lastUpdateDate: 商品が最後に更新された時刻。googleExpirationDate: 商品が期限切れになる日付。productId: 商品の REST ID。title: 商品のタイトル。link: 商品の URL リンク。destinationStatuses: 各配送先と国における商品のステータス。
リクエスト時に商品に商品アイテム単位の問題がある場合のみ、レスポンスに itemLevelIssues フィールドが表示されます。
JSON レスポンスの例を次に示します。
{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "strong_id_inaccurate",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "mpn",
"destination": "Shopping",
"description": "Incorrect product identifier [mpn]",
"detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
"documentation": "https://support.google.com/merchants/answer/160161",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "image_link_internal_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"destination": "Shopping",
"description": "Processing failed [image link]",
"detail": "Wait for the product image to be crawled again (up to 3 days)",
"documentation": "https://support.google.com/merchants/answer/6240184",
"applicableCountries": [
"US, UK"
]
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"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",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"destination": "Shopping",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}
すべての商品ステータスを一覧表示する
productstatuses.list を使用すると、すべての商品とそのステータスを確認できます。
次のパラメータを使用してクエリを絞り込むことができます。
destinations: ステータスを表示するデスティネーション。pageToken: 結果の後続ページを取得するために使用します。各ページには、一連の次のページを取得するために使用できるnextPageTokenがあります。maxResults: ページあたりの結果の最大数。
以下は、オプションのクエリ パラメータを含む list リクエストの例です。
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9
JSON レスポンスの例を次に示します。
{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
"title": "Green Headphones",
"link": "https://example.com/green-headphones/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"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",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US, UK"
]
},
{
"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",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2020-01-09T15:36:39Z",
"lastUpdateDate": "2020-01-14T19:17:02Z",
"googleExpirationDate": "2020-02-13T19:17:02Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:43",
"title": "Green shirt",
"link": "https://example.com/shirt-green/",
"destinationStatuses": [
{
"destination": "ShoppingActions",
"status": "approved",
"approvedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:40",
"title": "Black hat",
"link": "https://example.com/hat-black/",
"destinationStatuses": [
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
}
]
}
productstatuses.list 呼び出しはデータを変更しないため、本番環境で安全にテストできます。
送信先
ショッピングの商品に使用できる掲載先は次のとおりです。
shopping ads: ショッピング広告の商品。ShoppingActions: 「Google で購入」の商品。surfaces across google: 無料リスティングの商品。shopping: ローカル在庫広告の商品。
商品アイテム単位の問題
商品アイテム単位の各問題には、次のフィールドが含まれます。
code: 問題の判別に使用されたエラーコード。servability: 商品が次のように表示されているかどうかを示します。disapproved: この問題により商品が表示されません。unaffected: 商品は引き続き表示されます。
resolution: 販売者が問題を解決できるかどうかを示します。attributeName: 影響を受ける属性名。destination: 影響を受ける宛先。description: 商品の説明。detail: 問題に関する詳細情報を提供します。documentation: 問題に関するドキュメントが掲載されている場所を示します。applicableCountries: 問題が商品に影響している国を示します。