Content API for Shopping から在庫管理を移行する

Merchant API を使用すると、ローカル(店舗)および地域の在庫を管理できます。

リクエスト

Inventories サブ API には、次のリクエスト URL 形式を使用します。

POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories

Merchant API では、Inventories サブ API と関連するエンドポイントは複数形の「inventories」と呼ばれます。

ローカル在庫リクエストの Content API for Shopping と Merchant Inventories API の比較例を次に示します。

Content API Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories
識別子 {MERCHANT_ID}/products/{PRODUCT_ID} {NAME}

メソッド

Merchant API には、在庫管理用の次の 2 つの新しいメソッドが導入されています。

  • 商品のローカル在庫と地域別の在庫を掲載する
  • 商品からローカル在庫と地域別在庫を削除する

Content API for Shopping と Merchant Inventories API の在庫メソッドの比較を次に示します。

メソッド Content API for Shopping Merchant API
customBatch はい いいえ
insert
list いいえ はい
delete いいえ はい

ローカル在庫

Merchant Inventories API のローカル在庫に関する変更は次のとおりです。

Content API for Shopping Merchant API 説明
サポート対象外 name:string product 内の LocalInventory リソースを区別するための新しいフィールドを追加しました。Content API for Shopping では、ローカル在庫は storeCodeproductId で識別されます。
サポート対象外 account:string productLocalInventory が属する販売アカウントを識別する新しいフィールドを追加しました。
price: {

object (Price)

}

price: {

object (Price)

}

Price の定義が変更されました。
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

Price の定義が変更されました。
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate は、Merchant Inventories API の新しい TimePeriod タイプを使用します。
quantity:string, quantity:integer Merchant Inventories API では、quantity に文字列ではなく整数を指定します。
kind:string サポート対象外 kind は Merchant Inventories API ではサポートされていません。
サポート対象外 localShippingLabel:string Merchant Inventories API に、ローカル配送サービスにラベルを付ける新しいフィールドを追加しました。

地域別の在庫

Merchant Inventories API の地域別広告在庫の変更点は次のとおりです。

Content API for Shopping Merchant API 説明
サポート対象外 name:string product 内の regionalInventory リソースを区別するための新しいフィールドを追加しました。Content API for Shopping では、regionIdproductId で地域別の在庫を識別します。
サポート対象外 account:string productregionalInventory が属する販売アカウントを識別する新しいフィールドを追加しました。
"regionId": string "region": string regionID は、Merchant Inventories API では region と呼ばれます。
price: {

object (Price)

}

price: {

object (Price)

}

Price の定義が変更されました。
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

Price の定義が変更されました。
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate は、Merchant Inventories API の新しい TimePeriod タイプを使用します。
kind:string サポート対象外 kind は Merchant Inventories API ではサポートされていません。