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: 問題が商品に影響する国を示します。