ローカル フィード パートナー API

ローカル フィード パートナー プログラムを利用すると、小売店はメインフィードとローカル商品在庫フィードを作成することなく、ローカル在庫広告や無料ローカル商品リスティングを掲載できます。小売店は、売上データと在庫情報を信頼できるデータ プロバイダに提供し、そのプロバイダが Google と情報を共有できるようにします。サポートされているデータ パートナーの一覧については、ローカル フィード パートナー プログラムについてをご覧ください。

ローカル商品在庫を追加するには、ローカル商品在庫フィードをアップロードします。ローカル商品の在庫フィードには、店舗で販売できる商品アイテムのリストと、そのアイテムを説明する属性が含まれています。

在庫データ プロバイダを Merchant Center に追加するには、こちらのフォームに詳細情報をご記入ください。

販売店のオンボーディング ステータスを取得する

GetLfpState メソッドを使用すると、ローカル フィード パートナーシップ統合に関連する販売者レベルのプロパティのステータスを取得できます。提供されたプロパティに基づいて、統合が意図したとおりに機能しているかどうか、または追加の操作が必要かどうかを確認できます。

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

広告枠を挿入する

広告枠を挿入するには、次のリクエストを使用します。

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

次のようなレスポンスが返されます。

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

詳細については、メソッド: accounts.lfpInventories.insert をご覧ください。

セールを挿入する

販売を挿入するには、次のリクエストを使用します。

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

次のようなレスポンスが返されます。

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

詳細については、メソッド: accounts.lfpSales.insert をご覧ください。

店舗を挿入する

ストアを挿入するには、次のリクエストを使用します。

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

次のようなレスポンスが返されます。

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

詳細については、メソッド: accounts.lfpStores.insert をご覧ください。

販売店に通知を送信する

SendLfpNotification メソッドを使用して、販売店に通知を送信できます。たとえば、このメソッドを使用して、販売店にオンボーディング通知を送信できます。

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

次のように置き換えます。

  • {accountId}: Merchant Center アカウントの一意の識別子
  • {targetMerchantId}: 通知を送信するアカウントの一意の識別子
  • {emailAddress}: 通知を送信するアカウントのメールアドレス
  • {Type}: このフィールドには文字列値 ONBOARDING_UI のみを渡すことができます。