本地 Feed 合作伙伴关系 API

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

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

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

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

检索零售商的初始配置状态

您可以使用 GetLfpState 方法检索与本地 Feed 合作伙伴集成相关的商家级媒体资源的状态。根据提供的媒体资源,您可以检查集成是否按预期运行,或者是否需要执行任何其他操作。

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

插入商品目录

如需插入商品目录,请使用以下请求:

POST https://merchantapi.googleapis.com/lfp/v1beta/{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}"
}

您可能会看到以下响应:

{
 "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/v1beta/{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}"
}

您可能会看到以下响应:

{
 "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/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_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/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

替换以下内容:

  • {accountId}:您的 Merchant Center 账号的唯一标识符
  • {targetMerchantId}:您要向其发送通知的账号的唯一标识符
  • {emailAddress}:您希望向其发送通知的账号的电子邮件地址
  • {Type}:您只能在此字段中传递字符串值 ONBOARDING_UI