店面動態饋給合作夥伴 API

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

上傳店面商品目錄動態饋給，即可新增店面商品目錄資料。

如要將商品目錄資料供應商新增至 Merchant Center，請前往「銷售點資料供應商意見回饋，在 Google 上顯示店面產品」頁面提供詳細資料。

如要瞭解如何從 Content API for Shopping 遷移，請參閱遷移店面動態饋給合作夥伴。

擷取零售商的註冊狀態

你可以使用 lfpMerchantStates.get 方法，擷取與店面動態饋給合作夥伴整合相關的商家層級屬性狀態。根據提供的屬性，您可以檢查整合是否正常運作，或是否需要採取其他行動。

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 帳戶的專屬 ID。
  • {OFFER_ID}：產品的專屬 ID。
  • {STORE_CODE}：商家的商店 ID。
  • {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}：商店的專屬 ID。
  • {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」。