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

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

ローカル商品在庫を追加するには、ローカル商品在庫フィードをアップロードします。

在庫データ プロバイダを Merchant Center に追加するには、Google でローカル商品を表示するための POS データ プロバイダのフィードバックで詳細情報を提供してください。

Content API for Shopping からの移行については、ローカル フィード パートナーシップを移行するをご覧ください。

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

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 のみを渡すことができます。