Local Feeds Partnership API

零售商可以通过本地 Feed 合作伙伴关系计划参与本地商品目录广告和非付费本地商品详情，而无需创建自己的主要 Feed 和本地商品目录 Feed。零售商可以向可信数据提供商提供其销售和商品目录信息，由后者与 Google 分享这些信息。如需查看受支持的数据合作伙伴列表，请参阅本地 Feed 合作伙伴关系计划简介。

您可以通过上传本地商品目录 Feed 来添加本地商品目录。

如需将您的商品目录数据提供商添加到 Merchant Center，请在销售终端数据提供商反馈：在 Google 上展示本地商品中提供您的详细信息。

如需了解如何从 Content API for Shopping 迁移，请参阅迁移本地 Feed 合作伙伴关系。

检索零售商的新手入门状态

您可以使用 lfpMerchantStates.get 方法检索与本地 Feed 合作伙伴关系集成相关的商家级属性的状态。根据提供的属性，您可以检查集成是否按预期运行，或者是否需要采取任何其他措施。

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。