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 では、ローカル在庫は storeCode と productId で識別されます。 |
サポート対象外 | account:string
|
product と LocalInventory が属する販売アカウントを識別するための新しいフィールドを追加しました。 |
price: {
|
price: {
|
Price の定義が変更されました。 |
salePrice: {
|
salePrice: {
|
Price の定義が変更されました。 |
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
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 では、regionId と productId で地域別の在庫を識別します。 |
サポート対象外 | account:string
|
product と regionalInventory が属する販売アカウントを識別する新しいフィールドを追加しました。
|
"regionId": string
|
"region": string
|
regionID は、Merchant Inventories API では region と呼ばれます。 |
price: {
|
price: {
|
Price の定義が変更されました。 |
salePrice: {
|
salePrice: {
|
Price の定義が変更されました。 |
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate は、Merchant Inventories API の新しい TimePeriod タイプを使用します。 |
kind:string
|
サポート対象外 | kind は Merchant Inventories API ではサポートされていません。 |