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。