遷移店面動態饋給合作夥伴

您可以使用 Merchant API,將商品目錄、商店和銷售資料提供給 Google,以提升能見度和管理成效。

要求

針對店面動態饋給合作夥伴 API,請使用以下要求網址格式:

POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert

針對插入商品目錄的要求,可對 Content API for Shopping 與本地動態饋給合作夥伴 API 進行比較範例:

Content API 商家 API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
ID {merchantId}/pos/{targetMerchantId} {parent}

以下比較針對插入銷售資料的要求,將 Content API for Shopping 與本地動態饋給合作夥伴 API 進行比較範例:

Content API 商家 API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert
ID {merchantId}/pos/{targetMerchantId} {parent}

以下範例比較了 Content API for Shopping 與本地動態饋給合作夥伴 API,以針對插入商店的要求:

Content API 商家 API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert
ID {merchantId}/pos/{targetMerchantId} {parent}

方法

以下是店面動態饋給合作夥伴 API 中商店 API 方法的異動:

方法 Content API for Shopping 中的網址 Merchant API 中的網址 Content API for Shopping 中的 ID Merchant API 中的 ID 說明
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert {merchantId}/pos/{targetMerchantId} {parent} parent的格式是 accounts/{lfpPartnerAccountId}
delete DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {merchantId}/pos/{targetMerchantId}/store/{storeCode} {name} name的格式是 accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
get GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode} GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {merchantId}/pos/{targetMerchantId}/store/{storeCode} {name} name的格式是 accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
list GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores /{merchantId}/pos/{targetMerchantId} {parent} {parent}的格式是 accounts/{lfpPartnerAccountId}

以下說明店面動態饋給合作夥伴 API 中的 Inventory API 方法異動:

方法 Content API for Shopping 中的網址 Merchant API 中的網址 Content API for Shopping 中的 ID Merchant API 中的 ID 說明
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert {merchantId}/pos/{targetMerchantId} {parent} parent的格式是 accounts/{lfpPartnerAccountId}

以下是店面動態饋給合作夥伴 API 中銷售 API 方法的異動內容:

方法 Content API for Shopping 中的網址 Merchant API 中的網址 Content API for Shopping 中的 ID Merchant API 中的 ID 說明
insert POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert {merchantId}/pos/{targetMerchantId} {parent} {parent}的格式是 accounts/{lfpPartnerAccountId}

資源

以下是店面動態饋給合作夥伴 API 中商店資源的相關異動。未列在此處的欄位保持不變。

Content API for Shopping 商家 API 說明
無權限 name: string 新增欄位來區分不同商店
無權限 targetAccount: integer 用於插入商品目錄的商家帳戶
targetCountry: string regionCode: string targetCountry 已重新命名為 regionCode
websiteUrl: string websiteUri: string websiteUrl 已重新命名為 websiteUri
kind: string 無權限 店面動態饋給合作夥伴 API 不支援 kind

以下為插入廣告空間的相關異動。未在這裡選取的欄位則維持不變。

Content API for Shopping 商家 API 說明
無權限 name: string 新增欄位來區分不同廣告空間
無權限 targetAccount: integer 用於插入商品目錄的商家帳戶。
targetCountry: string regionCode: string targetCountry 已重新命名為 regionCode。產品銷售國家/地區的 CLDR 地域代碼。
itemId: string offerId: string itemId 已重新命名為 offerId
quantity: string quantity: string quantity」已更新為選用欄位
無權限 availability: string 必須提供availability

price: {

object (Price)

}

price: {

object (Price)

}

價格定義已變更。詳情請參閱「價格」一節。
timestamp: string collectionTime: string timestamp 已重新命名為 collectionTime
kind: string 無權限 店面動態饋給合作夥伴 API 不支援 kind

插入銷售活動的相關異動如下。未在這裡選取的欄位則維持不變。

Content API for Shopping 商家 API 說明
無權限 name: string 新增欄位來區分不同廣告空間
無權限 targetAccount:integer 要用於插入銷售項目的商家帳戶
targetCountry: string regionCode: string 產品銷售國家/地區的 CLDR 地域代碼。
itemId: string offerId: string itemId 已重新命名為 offerId

price: {

object (Price)

}

price: {

object (Price)

}

價格定義已變更。詳情請參閱「價格」一節。
timestamp: string saleTime: string timestamp 已重新命名為 saleTime
kind: string 無權限 店面動態饋給合作夥伴 API 不支援 kind