您可以使用 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 |
|
|
價格定義已變更。詳情請參閱「價格」一節。 |
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 |
|
|
價格定義已變更。詳情請參閱「價格」一節。 |
timestamp: string |
saleTime: string |
timestamp 已重新命名為 saleTime |
kind: string |
無權限 | 店面動態饋給合作夥伴 API 不支援 kind 。 |