加入店面動態饋給合作夥伴計畫之後,零售商就能刊登店面商品目錄廣告和免費區域產品資訊,不必自行建立主要和店面商品目錄動態饋給。零售商可以將銷售和商品目錄資訊提供給值得信賴的資料供應商,由對方將這些資訊分享給 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