ローカル在庫サービスを使用すると、ローカル在庫リソースのインスタンスを作成および更新できます。このリソースには、実店舗の場所ごとに異なる値を持つフィールドが含まれます。各ローカル在庫インスタンスは、既存の商品リソースの子であり、親リソースから商品データ フィールドを継承します。たとえば、ある商品の価格と数量が店舗ごとに異なるが、ID、商品説明、その他の商品データはすべての店舗で共通しているとします。ローカル在庫データは、Google 掲載のローカル情報とローカル在庫広告のプログラムで使用されます。
このガイドでは、ローカル在庫サービスの使用を開始する前に必要なもの、使用可能なフィールドとメソッド、サービス リクエストの例について説明します。
前提条件
- ローカル在庫サービスを使用するには、ビジネス プロフィールを作成し、ビジネス プロフィールを Merchant Center アカウントにリンクし、ビジネスのオーナー確認を行い、ビジネス プロフィールの店舗コードを設定する必要があります。
Merchant Center アカウントは、ローカル プログラム(ローカル情報 Google 掲載またはローカル在庫広告)に登録されている必要があります。Content API を通じてローカル在庫広告を使用する方法について詳しくは、ローカル在庫広告を使ってみるをご覧ください。
ローカル在庫サービスは、既存のローカル商品のローカル在庫インスタンスを作成します。まず、Content API 商品サービスまたは Merchant Center のデータフィードを使用して、
channel
フィールドをlocal
に設定し、ローカル商品を作成する必要があります。ローカル在庫サービスを使用して、商品が販売されているビジネス プロフィールstorecode
ごとにローカル在庫インスタンスを作成します。
フィールド
各ローカル在庫インスタンスには、storeCode
フィールド(ビジネス プロフィールで定義する)を介して特定の店舗の場所に関連付けられた一連のフィールドが含まれています。すべてのリクエストで storecode
と productId
のみが必要です。その他のフィールドはすべて省略可能です。
- すべてのリクエストで必須:
storeCode
、productId
(URL 内) - 省略可:
quantity
、price
、salePrice
、salePriceEffectiveDate
、availability
、pickupMethod
、pickupSla
、instoreProductLocation
ローカル在庫フィールドとその説明の一覧については、localinventory リファレンス ページをご覧ください。
Methods
ローカル在庫サービスには次の 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 つのローカル商品に複数のローカル在庫インスタンスを作成したり、複数のローカル商品に対してローカル在庫インスタンスを作成したりできます。