Merchant API を使用すると、在庫、店舗、販売データを Google と共有して、可視性と管理性を高めることができます。
新機能
Merchant API には、Content API の機能に加えて、次の新機能があります。
- ローカル フィード パートナーシップの統合に関連するビジネスレベルのプロパティの状態を取得するメソッド
- 販売店に通知を送信する方法
これらのメソッドの詳細については、ローカル フィード パートナーシップ API をご覧ください。
リクエスト
ローカル フィード パートナーシップ API には、次のリクエスト URL 形式を使用します。
POST https://merchantapi.googleapis.com/lfp/v1/{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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{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/v1/{PARENT}/lfpInventories:insert |
{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/v1/{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 |
在庫を挿入する Merchant Center アカウント |
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 |
在庫を挿入する Merchant Center アカウント。 |
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 |
売上データを挿入する Merchant Center アカウント |
targetCountry: string |
regionCode: string |
商品を販売する国の CLDR 地域コード。 |
itemId: string |
offerId: string |
itemId の名前が offerId に変更されました。 |
|
|
価格の定義が変更されました。詳細については、料金をご覧ください。 |
timestamp: string |
saleTime: string |
timestamp の名前が saleTime に変更されました。 |
kind: string |
サポート対象外 | kind は、ローカル フィード パートナーシップ API ではサポートされていません。 |