ローカル フィード パートナー 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": "{TARGETMERCHANT_ID}"
}

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

  • {PARENT}: 形式は accounts/{ACCOUNT_ID} です。{ACCOUNT_ID} は Merchant Center アカウントの一意の識別子です。
  • {OFFER_ID}: 商品の一意の識別子。
  • {STORE_CODE}: 販売者のストアの識別子。
  • {TARGETMERCHANT_ID}: 在庫を送信するビジネスのアカウント 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/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": "{TARGETMERCHANT_ID}"
}

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

  • {TARGETMERCHANT_ID}: 販売を送信するビジネスのアカウント 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/v1/{PARENT}/lfpStores:insert

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

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

  • {STORE_CODE}: ストアの固有識別子。
  • {TARGETMERCHANT_ID}: ストアを送信するビジネスのアカウント 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/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 のみを渡すことができます。