Merchant API を使用すると、ローカル（店舗）と地域別の在庫を管理できます。
リクエスト
[広告枠] 項目には、次のリクエスト URL 形式を使用します。 サブ API:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
Merchant API では、Inventories サブ API と関連エンドポイントを 「inventory」と指定します
Content API for Shopping と販売者の比較例 ローカル在庫リクエスト用の Inventories API:
| コンテンツ API | 販売者 API | |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories |
| 識別子 | {merchantId}/products/{productId} |
{name}
|
メソッド
Merchant API では、在庫管理のために 2 つの新しいメソッドが導入されています。
- 商品のローカル在庫と地域別在庫を掲載します
- 商品からローカル在庫と地域別の在庫を削除する
Content API for Shopping の在庫メソッドの比較 Merchant Inventories API は
| メソッド | Content API for Shopping | 販売者 API |
|---|---|---|
customBatch |
○ | × |
insert |
○ | ○ |
list |
× | ○ |
delete |
× | ○ |
ローカル在庫
Merchant Inventories API のローカル在庫の変更点は次のとおりです。
| Content API for Shopping | 販売者 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 | 販売者 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 ではサポートされていません。
|