ローカル在庫サービスを使用すると、ローカル在庫リソースのインスタンスを作成して更新できます。このインスタンスには、実店舗の所在地ごとに異なる値を持つことができるフィールドが含まれています。各ローカル在庫インスタンスは既存の商品リソースの子であり、親リソースから商品データ フィールドを継承します。たとえば、店舗ごとに価格と数量が異なるが、ID、説明、その他の商品データはすべての店舗で共通の商品があるとします。ローカル在庫データは、ローカルの Google に掲載とローカル在庫広告のプログラムで使用されます。
このガイドでは、ローカル在庫サービスの使用を開始する前に必要なもの、利用可能なフィールドとメソッド、サービス リクエストの例について説明します。
前提条件
- ローカル在庫サービスを利用するには、ビジネス プロフィールを作成し、ビジネス プロフィールを Merchant Center アカウントにリンクし、ビジネスのオーナー確認を行い、ビジネス プロフィールの店舗コードを設定する必要があります。
Merchant Center アカウントが、「Google に掲載」またはローカル在庫広告のいずれかのローカル プログラムに登録されている必要があります。Content API を介してローカル在庫広告を使用する方法について詳しくは、ローカル在庫広告のご利用を開始するをご覧ください。
ローカル在庫サービスは、既存のローカル商品のローカル在庫インスタンスを作成します。まず、Content API の products サービスまたは Merchant Center のデータフィードを使用して、
channelフィールドをlocalに設定してローカル商品を作成する必要があります。ローカル在庫サービスを使用して、商品が販売されている各ビジネス プロフィールstorecodeのローカル在庫インスタンスを作成できます。
フィールド
各ローカル在庫インスタンスには、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 つのローカル商品に対して複数のローカル在庫インスタンスを作成したり、複数のローカル商品に対してローカル在庫インスタンスを作成したりできます。