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 | 販売者 API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
|
| 識別子 |
{merchantId}/pos/{targetMerchantId}
|
{parent} |
セールの挿入リクエストについて、Content API for Shopping とローカル フィード パートナーシップ API を比較した例を次に示します。
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
| 識別子 | {merchantId}/pos/{targetMerchantId} |
{parent} |
ストアの挿入リクエストについて、Content API for Shopping とローカル フィード パートナーシップ API を比較した例を次に示します。
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert |
| 識別子 | {merchantId}/pos/{targetMerchantId} |
{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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent の形式は accounts/{lfpPartnerAccountId} です。 |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name の形式は accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} です |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} |
{merchantId}/pos/{targetMerchantId}/store/{storeCode} |
{name} | name の形式は accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode} です |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores |
/{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} の形式は accounts/{lfpPartnerAccountId} です。 |
ローカル フィード パートナーシップ 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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | parent の形式は accounts/{lfpPartnerAccountId} です。 |
ローカル フィード パートナーシップ 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/{merchantId}/pos/{targetMerchantId}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert |
{merchantId}/pos/{targetMerchantId} |
{parent} | {parent} の形式は accounts/{lfpPartnerAccountId} です |
リソース
ローカル フィード パートナー 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 ではサポートされていません。 |