Merchant API を使用すると、在庫、店舗、販売データを Google と共有して、可視性と管理を高めることができます。
新機能
Merchant API には、Content API の機能に加えて、次の新機能があります。
- ローカル フィード パートナーシップの統合に関連する販売者レベルのプロパティのステータスを取得するメソッド
- 販売店に通知を送信する方法
これらのメソッドの詳細については、ローカル フィード パートナーシップ API をご覧ください。
リクエスト
ローカル フィード パートナーシップ API には、次のリクエスト URL 形式を使用します。
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
詳細については、メソッド: accounts.lfpInventories.insert をご覧ください。
在庫の挿入リクエストについて、Content API for Shopping とローカル フィード パートナーシップ API を比較したサンプルを次に示します。
| Content API | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
|
| 識別子 |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
セールの挿入リクエストについて、Content API for Shopping とローカル フィード パートナーシップ API を比較した例を次に示します。
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert |
| 識別子 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
ストアの挿入リクエストについて、Content API for Shopping とローカル フィード パートナーシップ API を比較した例を次に示します。
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert |
| 識別子 | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
メソッド
ローカル フィード パートナーシップ API のストア API メソッドの変更点は次のとおりです。
| メソッド | Content API for Shopping の URL | Merchant API の URL | Content API for Shopping の ID | Merchant API の識別子 | 説明 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent の形式は accounts/{IFP_PARTNER_ACCOUNT_ID} です。 |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name の形式は accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}～{STORE_CODE} です。 |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name の形式は accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}～{STORE_CODE} です。 |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} の形式は accounts/{IFP_PARTNER_ACCOUNT_ID} です。 |
ローカル フィード パートナーシップ API の在庫 API メソッドの変更点は次のとおりです。
| メソッド | Content API for Shopping の URL | Merchant API の URL | Content API for Shopping の ID | Merchant API の識別子 | 説明 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent の形式は accounts/{IFP_PARTNER_ACCOUNT_ID} です。 |
ローカル フィード パートナーシップ API の sales API メソッドの変更点は次のとおりです。
| メソッド | Content API for Shopping の URL | Merchant API の URL | Content API for Shopping の ID | Merchant API の識別子 | 説明 |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} の形式は accounts/{IFP_PARTNER_ACCOUNT_ID} です。 |
リソース
ローカル フィード パートナーシップ API の店舗リソースの変更点は次のとおりです。ここに含まれていないフィールドは変更されません。
| Content API for Shopping | Merchant API | 説明 |
| サポート対象外 | name: string |
店舗を区別するための新しいフィールドを追加しました |
| サポート対象外 | targetAccount: integer |
在庫を挿入する販売者のアカウント |
targetCountry: string |
regionCode: string |
targetCountry の名前が regionCode に変更されました。 |
websiteUrl: string |
websiteUri: string |
websiteUrl の名前が websiteUri に変更されました。 |
kind: string |
サポート対象外 | kind はローカル フィード パートナーシップ API でサポートされていません |
広告在庫の挿入に関する変更点は次のとおりです。ここに含まれていないフィールドは変更されません。
| Content API for Shopping | Merchant API | 説明 |
| サポート対象外 | name: string |
さまざまな広告枠を区別するための新しいフィールドを追加しました |
| サポート対象外 | targetAccount: integer |
在庫を挿入する販売者のアカウント。 |
targetCountry: string |
regionCode: string |
targetCountry の名前を regionCode に変更しました。商品を販売する国の CLDR 地域コード。 |
itemId: string |
offerId: string |
itemId の名前が offerId に変更されました。 |
quantity: string |
quantity: string |
quantity を省略可能に更新しました |
| サポート対象外 | availability: string |
availability は必須です |
|
|
料金の定義が変更されました。詳細については、料金をご覧ください。 |
timestamp: string |
collectionTime: string |
timestamp の名前が collectionTime に変更されました。 |
kind: string |
サポート対象外 | kind は、ローカル フィード パートナーシップ API ではサポートされていません。 |
セールの挿入に関する変更点は次のとおりです。ここに含まれていないフィールドは変更されません。
| Content API for Shopping | Merchant API | 説明 |
| サポート対象外 | name: string |
さまざまな広告枠を区別するための新しいフィールドを追加しました |
| サポート対象外 | targetAccount:integer |
販売を挿入する販売アカウント |
targetCountry: string |
regionCode: string |
商品を販売する国の CLDR 地域コード。 |
itemId: string |
offerId: string |
itemId の名前が offerId に変更されました。 |
|
|
料金の定義が変更されました。詳細については、料金をご覧ください。 |
timestamp: string |
saleTime: string |
timestamp の名前が saleTime に変更されました。 |
kind: string |
サポート対象外 | kind は、ローカル フィード パートナーシップ API ではサポートされていません。 |