ローカル フィード パートナーシップ API

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

ローカル商品在庫フィードをアップロードして、ローカル商品在庫を追加できます。

在庫データ プロバイダを Merchant Center に追加するには、 販売時点情報管理データ プロバイダのフィードバック で詳細を入力して、Google にローカル商品を表示できるようにします。

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

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

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

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

在庫を挿入する

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

POST https://merchantapi.googleapis.com/lfp/v1/{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": "{TARGET_MERCHANT_ID}"
}

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

  • {PARENT}: 形式は accounts/{ACCOUNT_ID} です。{ACCOUNT_ID} は Merchant Center アカウントの一意の識別子です。
  • {OFFER_ID}: 商品の一意の識別子。
  • {STORE_CODE}: 販売者のストアの識別子。
  • {TARGET_MERCHANT_ID}: 在庫を送信するビジネスの アカウント ID。

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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/v1/{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": "{TARGET_MERCHANT_ID}"
}

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

  • {TARGET_MERCHANT_ID}: 販売を送信するビジネスの アカウント ID。

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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/v1/{PARENT}/lfpStores:insert

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

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

  • {STORE_CODE}: 店舗の固有識別子。
  • {TARGET_MERCHANT_ID}: 店舗を送信する ビジネスのアカウント ID。

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "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/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

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

  • {ACCOUNT_ID}: Merchant Center アカウントの一意の識別子。
  • {TARGETMERCHANT_ID}: 通知を送信するアカウントの一意の識別子 。
  • {EMAIL_ADDRESS}: 通知を送信する アカウントのメールアドレス。
  • {TYPE}: このフィールドに渡せる文字列値は ONBOARDING_UI のみです。