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

你可以使用 Merchant API 與 Google 分享商品目錄、商店和銷售資料,以便提升曝光度和管理效率。

新功能

除了 Content API 功能外,Merchant API 還提供下列新功能:

  • 擷取與本地動態饋給合作夥伴整合相關的賣家層級資源狀態的方法
  • 傳送通知給零售商的方法

如要進一步瞭解這些方法,請參閱「店面動態饋給合作夥伴 API」。

要求

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

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

詳情請參閱「方法:accounts.lfpInventories.insert」。

以下是插入商品目錄要求的 Content API for Shopping 與本地動態饋給合作夥伴 API 的比較範例:

Content API Merchant API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
ID {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

以下是插入銷售要求的 Content API for Shopping 與本地動態饋給合作夥伴 API 的比較範例:

Content API Merchant API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert
ID {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

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

Content API Merchant API
網址 POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert
ID {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}
delete DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} name 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
get GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*} {MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} {NAME} name 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
list GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores /{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}

以下是店面動態饋給合作夥伴 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}

以下是本地動態饋給合作夥伴 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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} 的格式為 accounts/{IFP_PARTNER_ACCOUNT_ID}

資源

以下是本地動態饋給合作夥伴 API 中商店資源的異動內容。未列入此處的欄位則保持不變。

Content API for Shopping Merchant 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 Merchant 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 Merchant 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