本地 Feed 合作伙伴关系 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": "{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。