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。