店面動態饋給合作夥伴 API

加入店面動態饋給合作夥伴計畫之後,零售商就能刊登店面商品目錄廣告和免費區域產品資訊,不必自行建立主要和店面商品目錄動態饋給。零售商可以將銷售和商品目錄資訊提供給值得信賴的資料供應商,由對方將這些資訊分享給 Google。如需支援的資料合作夥伴清單,請參閱「店面動態饋給合作夥伴計畫簡介」。

你可以上傳店面商品目錄動態饋給,新增店面商品目錄。店面商品目錄動態饋給會列出可在實體店內販售的商品清單,以及用來描述這些商品的屬性。

如要將商品目錄資料供應商新增至 Merchant Center,請在這個表單中提供詳細資料。

擷取零售商的註冊狀態

您可以使用 GetLfpState 方法,擷取與本機動態饋給合作夥伴整合相關的「商家」層級資源狀態。根據提供的資源,您可以檢查整合是否正常運作,或是否需要採取其他行動。

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 帳戶的專屬 ID
  • {targetMerchantId}:您要傳送通知的帳戶專屬 ID
  • {emailAddress}:您要傳送通知的帳戶電子郵件地址
  • {Type}:您只能在這個欄位中傳遞字串值 ONBOARDING_UI