Product
リソースを使用すると、ショッピングの商品の詳細なステータスを確認できます。
Content API では、ProductStatuses.get
メソッドを呼び出すことで商品のステータスを取得できます。Merchant API では、Accounts.Products
リソースを取得することで商品のステータスを取得できます。
販売者には、ショッピング広告と無料リスティングのポリシーを遵守する責任があります。ショッピング広告は、これらのポリシーを適用し、ポリシーに違反するコンテンツや行為が検出された際に適切に対処する権利を有します。
要件
商品のステータスを表示するには、次の操作を行う必要があります。
- 移行先のアカウントを登録します。
- 次のいずれかに有効な国コードを指定します。
feedLabel
フィールド。shipping
フィールド。- フィード単位。
- アカウントの配送設定。
商品のステータスを取得する
Accounts.Products
リソースを取得して、商品のステータスを表示します。
GET
リクエストの例を次に示します。
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
products.get
からのすべてのレスポンスには、次のフィールドが含まれます。
creationDate
: 商品が作成された日付。lastUpdateDate
: 商品が最後に更新された時刻。googleExpirationDate
: 商品の有効期限が切れる日付。destinationStatuses
: 商品の送信先。itemLevelIssues
: 商品に関連するすべての問題のリスト。
リクエスト時に商品に商品アイテムレベルの問題がある場合にのみ、レスポンスに itemLevelIssues
フィールドが表示されます。
JSON レスポンスの例を次に示します。
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "288000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
すべての商品ステータスを一覧表示する
products.list
を使用すると、すべての商品とそのステータスを確認できます。
次のパラメータを使用してクエリを絞り込むことができます。
pageToken
: 結果の次のページを取得するために使用します。すべてのページにnextPageToken
があり、これを使用して一連のページの次のページを取得できます。maxResults
: ページあたりの結果の最大数。
オプションのクエリ パラメータを含む list
リクエストの例を次に示します。
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
JSON レスポンスの例を次に示します。
{
"nextPageToken": "632fd090c95712c6",
"products": [
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/10355371287",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "28800000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
]
}
productstatuses.list
呼び出しはデータを変更しないため、本番環境で安全にテストできます。
商品アイテム単位の問題
商品アイテム単位の各問題には次のフィールドがあります。
code
: 問題のエラーコード。severity
: 問題の重大度。resolution
: 販売者が問題を解決できるかどうかを示します。attribute
: 影響を受ける属性名。reportingContext
: 問題が適用されるレポートのコンテキスト。description
: 問題の説明。detail
: 問題に関する詳細情報を提供します。documentation
: 問題に関するドキュメントの URL。applicableCountries
: どの国で問題がプロダクトに影響するかを示します。