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

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

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

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

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}: 販売者の店舗の ID。
  • {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 のみを渡すことができます。