ローカル フィード パートナーシップを移行する

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 は必須です

price: {

object (Price)

}

price: {

object (Price)

}

価格の定義が変更されました。詳細については、料金をご覧ください。
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 に変更されました。

price: {

object (Price)

}

price: {

object (Price)

}

価格の定義が変更されました。詳細については、料金をご覧ください。
timestamp: string saleTime: string timestamp の名前が saleTime に変更されました。
kind: string サポート対象外 kind は、ローカル フィード パートナーシップ API ではサポートされていません。