このページは Cloud Translation API によって翻訳されました。

商品のリソース呼び出し

products 使用できるため、多くのリソースについて必須フィールドが多数ありますが Google ショッピングでの表示の承認を得るには、商品を指定して追加する必要があります。状況に応じていくつかのオプションフィールドを必須にできます。場所、商品のタイプ、バリエーション、商品などの条件をあります。使用できる 60 以上のオプションパラメータについて詳しくは、詳しくは、商品データ仕様をご覧ください。

products リソースを使用すると、insert、get、update、delete のいずれかを使用できます。同時に、および Merchant Center データベース内のすべての商品を list とします。

「 productstatuses リソースを使用して、特定のリソースの承認状況ターゲットに指定します詳しくは、プロダクトのステータスのガイドをご覧ください。商品にデータ品質の問題がある可能性と、その問題の内容を確認できます。

API の例では、3 つのプロダクトを使用します。2 つは Google の T シャツ、もう 1 つは Google の上限。以下の表に示す商品データの最小セットを使用して、 products リソース呼び出しを行って挿入、取得、更新、一覧表示、削除を行う個別商品や商品のバッチです

送料と税金の情報を設定することをおすすめしますアカウントレベルです。定義できます。

複数販売者サブアカウントの場合ショッピングモール: すべての商品が external_seller_id フィールドを含めます。詳しくは、プロダクト ID をご覧ください。


id	online:en:US:1111111111	online:en:US:2222222222	online:en:US:3333333333
offerId	1111111111	2222222222	3333333333
title	黒の Google T シャツ	Google T シャツ（緑）	Google ツイルキャップ
description	黒の Google T シャツ	綿 100% の Google T シャツ	Google のキャップ（クラシック）
商品グループ ID	google_tee	google_tee
リンク	http://my.site.com/blacktee	http://my.site.com/greentee	http://my.site.com/blackhat
条件	新規	新規	新規
価格	2199.00 JPY	2199.00 JPY	1099.00 JPY
稼働率	在庫あり	在庫あり	在庫あり
imageLink	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg	https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
gtin	9504000059422	9504000059446	9504000059452
mpn（製品番号）	00638NIC	00638ANG	00638ABC
brand	Google	Google	Google
Google 商品カテゴリ	アパレル、アクセサリ >衣類	アパレル、アクセサリ >衣類	アパレル、アクセサリ >ファッション・アクセサリー >帽子
色	Black	緑	Black
サイズ	L	M	M
age_group	アダルト	アダルト	アダルト
gender	男性	男性	男女共用
included_destination	ショッピングアクション、ショッピング広告	ショッピングアクション、ショッピング広告	Shopping Actions

products.insert

単一の商品を挿入するには、次のリクエスト URL を使用して、販売者 ID とサンプル JSON 本文を入力します。挿入により新しい商品が作成されます。IF 値属性 channel、contentLanguage、offerId、および特定の商品について feedLabel である場合、このメソッドはそのエントリを更新し、そのプロダクトの以前の API 呼び出しのすべてのデータ。

すべての掲載先で 7 日以上除外されている商品は、削除されます。

この例では、新しい「Black Google T シャツ」が挿入されています。商品に絞り込めます。

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

products.insert のリクエスト本文の呼び出し例:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

商品には、JSON 本文内でカスタム属性を設定することもできます。たとえば単一の商品に purchase_quantity_limit を設定して、注文できる商品アイテム数:

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

なお、purchase_quantity_limit カスタム属性は購入上限を設定します。商品定義に追加され、フィードでもサポートされています。「属性は、API で完全にサポートされるまではベータ版です。制限なし販売者がカスタム属性を追加することはできますが、 API による特定の処理。

呼び出しが成功すると、HTTP 200 コードと、次を含むレスポンス本文が返されます。挿入された商品リソース（id、offerId、contentLanguage、 feedLabel と channel に入力済み:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

Merchant Center データベース内の特定の商品の情報を取得するには、次のコマンドを使用します。 products.get。新しく挿入された商品が反映されるまでに数分かかることがあります。この通話では対応できません

以下の HTTP リクエスト URL とパラメータ、販売者 ID、取得する商品の商品 ID（REST ID 形式）:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

呼び出しが成功すると、HTTP 200 と「商品リソース」が返されます。のレスポンスの本文ですこれは、ID を持つ商品から取得した商品データの例を示したものです。 online:en:US:1111111111:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

単一の商品を更新するには、PATCH メソッドで次のリクエスト URL を使用します。販売者 ID と商品 ID のほか、リクエストするデータを含む JSON 本文が指定します。products.insert とは異なり、該当するすべてのフィールドを指定する必要があります。products.update で必要な操作は、変更するフィールドを指定します。

属性を追加または変更するには、JSON で新しい値を含むフィールドを指定しますできます。この例では、既存のインスタンスの title と description を更新します。 "黒の Google T シャツ"商品データをリクエスト本文に貼り付けて、その他のフィールドはそのままにします

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

products.update のリクエスト本文の呼び出し例:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

products.update リクエストで更新できるのは、最上位のフィールドのみです。 ネストされたフィールドを更新する場合は、トップレベルオブジェクト全体を指定する必要があります。

ここに示されている例では、ネストされたオブジェクトを含む最上位の salePrice オブジェクトを更新します。を使用して、既存の商品のリクエストの本文を使用し、その他のフィールドはそのままにします。

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

他のフィールドに変更を加えることなく、特定のフィールドを選択して更新するリクエストの本文で updateMask を指定できます。このクエリ文字列パラメータは、変更するフィールドのカンマ区切りのリストである必要があります。 updateMask は、名前付きフィールドのみがが更新されます。updateMask を指定しない場合は、すべて更新するフィールドを定義します。

この例では、description と availability のみを更新します。既存の「黒の Google T シャツ」商品データをリクエスト本文。title を含む他のすべてのフィールドはそのままにします。

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

products.update のリクエスト本文の呼び出し例:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

フィールドが updateMask リストで指定されていて、リクエストの本文で指定されていない場合、このフィールドは、Product リソース（存在する場合）から削除されます。

この例では、updateMask を使用してフィールドの値を削除します。 salePrice。

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

次の目的のために、サンプルリクエストの本文に salePrice フィールドを含めないでください。削除します。本文を指定しないか、本文を空にすることもできます。他のフィールドは updateMask に含まれない場合はそのまま残ります。

products.custombatch リクエスト内で updateMask を使用するには、updateMask リクエストの本文で指定する必要があります。

この例では、既存のインスタンスの price と availability を更新します。 "黒の Google T シャツ"提供されている商品データで products.custombatch を使用する（title や description を含む他のすべてのフィールドは残します）あります。

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch

{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

単一の商品を削除するには、サンプル HTTP リクエストで products.delete を使用します。 URL、販売者 ID、商品 ID（ online:en:US:1111111111 など）を入力します。

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

成功すると、レスポンスの本文のない HTTP Status 204 が返されます。

products.list

products.list には、販売者が Merchant Center に登録しているすべての商品が一覧表示されます。データベースです次のリクエスト URL を使用します。

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

呼び出しが成功すると、商品の HTTP 200 と JSON データが返されます。「リソース」] キーを押します。

次の 3 つの商品例が返されます。

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}

Product IDs

バッチモード