ローカル在庫サービス

ローカル在庫サービスを使用すると、ローカル在庫リソースのインスタンスを作成して更新できます。このインスタンスには、実店舗の所在地ごとに異なる値を持つことができるフィールドが含まれています。各ローカル在庫インスタンスは既存の商品リソースの子であり、親リソースから商品データ フィールドを継承します。たとえば、店舗ごとに価格と数量が異なるが、ID、説明、その他の商品データはすべての店舗で共通の商品があるとします。ローカル在庫データは、ローカルの Google に掲載とローカル在庫広告のプログラムで使用されます。

このガイドでは、ローカル在庫サービスの使用を開始する前に必要なもの、利用可能なフィールドとメソッド、サービス リクエストの例について説明します。

前提条件

フィールド

各ローカル在庫インスタンスには、storeCode フィールド（ビジネス プロフィールで定義）を介して特定の店舗に関連付けられた一連のフィールドが含まれています。すべてのリクエストで storecode と productId のみが必須です。他のフィールドはすべて省略可能です。

  • すべてのリクエストで必須: storeCode、productId（URL 内）
  • 省略可: quantity、price、salePrice、salePriceEffectiveDate、availability、pickupMethod、pickupSla、instoreProductLocation

ローカル在庫フィールドとその説明の一覧については、localinventory リファレンス ページをご覧ください。

メソッド

ローカル在庫サービスには次の 2 つのメソッドのみが含まれます。

localinventory.insert

localinventory.insert を使用すると、単一のローカル商品に対してローカル在庫インスタンスを作成できます。

この例では、ローカル在庫サービスを使用して、2021 年 2 月 24 日午後 1 時（GMT-8）から 2021 年 2 月 28 日午後 3 時 30 分（GMT-8）まで店舗内セールを作成する方法を示します。このリクエストでは、ローカル在庫インスタンスの在庫数も更新されます。ローカル以外の商品データの補助フィードとは異なり、この呼び出しでは、リクエストの本文に含まれていないフィールドが上書きされます。

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

localinventory.custombatch を使用すると、複数の店舗にある 1 つのローカル商品に対して複数のローカル在庫インスタンスを作成したり、複数のローカル商品に対してローカル在庫インスタンスを作成したりできます。