遷移店面商品目錄廣告設定

如果你在 Shopping Content API 下使用店面商品目錄廣告設定，Merchant API 會有一些重要變更。

LIA 設定現在屬於三個核心元件之一，每個元件都有相關聯的資源。

核心元件	資源
全通路放送的帳戶設定	OmnichannelSetting
連結至店面動態饋給合作夥伴 (LFP)，取得商品目錄資料	LfpProvider
連結至 Google 商家檔案 (GBP) 帳戶，取得當地商店資料	GbpAccount

此外，使用 LIA 設定時，每個帳戶只有一個資源，其中包含每個國家/地區實體的設定清單。您可以使用 OmnichannelSettings 將多個資源與帳戶建立關聯。每個資源都代表特定國家/地區實體的設定。

以下說明要求和資源的變更方式。

要求

新網域	Content API 方法名稱	Merchant API 方法名稱
accounts.omnichannelSettings	liasettings.custombatch	這個方法即將淘汰。Merchant API 支援一次傳送多個要求。
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	我們不再直接提供取得所有子帳戶 LIA 設定的方法。請改為查詢所有子帳戶，並使用 accounts.omnichannelSettings.list 取得感興趣的子帳戶的 omnichannelSettings。
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	這個方法即將淘汰。請改用 accounts.omnichannelSettings.create 或 accounts.omnichannelSettings.update 搭配更新後的遮罩。
	liasettings.setomnichannelexperience	這個方法即將淘汰。請改用 accounts.omnichannelSettings.create 或 accounts.omnichannelSettings.update 搭配更新後的遮罩。
accounts.omnichannelSettings.lfpProvider	liasettings.listposdataproviders	accounts.omnichannelSettings.lfpProviders.findLfpProviders
	liasettings.setposdataprovider	accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount	liasettings.getaccessiblegmbaccounts	accounts.gbpAccount.list
	liasettings.requestgmbaccess	accounts.gbpAccount.linkGbpAccount

資源

• OmnichannelSetting
  • LsfType
  • InStock
  • Pickup
  • LfpLink
  • OnDisplayToOrder
  • 關於
  • InventoryVerification
• LfpProvider
• GbpAccount

此外，服務會針對 PickupType 執行不同的操作。請參閱「上車地點」。

OmnichannelSetting

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
(不適用)	(不適用)	name	string	這項全通路設定的資源名稱。格式： 格式：accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	必要欄位。 通用區域資料庫 (CLDR) 國家/地區代碼 (例如「US」)
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	必要欄位。 這個 regionCode 的 Local Store Front (LSF) 類型。可能的值包括： GHLSF (Google 代管的本地店面) MHLSF_BASIC (商家代管的本地店面 Basic，指的是提供店內供應情形的產品頁面) MHLSF_FULL (商家代管的本地店面完整版，指的是提供店內供應情形的產品頁面)
(不適用)	(不適用)	inStock	object (InStock)	這個 regionCode 的現貨產品網頁 URI (通用資源識別碼) 和放送狀態。如果您選擇其中一種 MHLSF 類型，請在建立 API 中設定至少一個 inStock 或 pickup 物件，但如果 lsfType 為 GHLSF，則只需設定 inStock。
storePickupActive	boolean	pickup	object (Pickup)	這個 regionCode 的到店取貨產品頁面 URI 和放送狀態。如果您選擇了其中一種 MHLSF 類型，但在 GHLSF 設為 lsfType 時未設定，請在建立 API 時設定至少一個 inStock 或 Pickup 物件。
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	僅供輸出。已建立的 LFP 供應器連結
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	這個 regionCode 的可訂購展示商品 (ODO) 政策 URI 和狀態
about	object (LiaAboutPageSettings)	about	object (About)	這個 regionCode 的關於頁面 URI 和狀態
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	這個 regionCode 的商品目錄驗證程序狀態和聯絡資訊
omnichannelExperience	object (LiaOmnichannelExperience)	(不適用)	(不適用)	請使用 lsfType 和 pickup (如上所述)。

LsfType

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
lsfType	string	lsfType	enum (LsfType)	本地店面 (LSF) 類型。可能的值包括： GHLSF (Google 代管的本地店面) MHLSF_BASIC (商家代管的本地店面基本版) MHLSF_FULL (商家代管的本地店面完整版)

InStock

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
(不適用)	(不適用)	uri	string	產品到達網頁 URI。如果您選擇了其中一種 MHLSF 類型，則必須提供此值。如果已設定物件，則為必填欄位。對於 GHLSF，該值必須為空白，但對於 MHLSF，則不得為空白。這項服務只會用於查看是否有庫存。這個 URI 網域應與商家首頁相符。
(不適用)	(不適用)	state	enum (ReviewState.State)	僅供輸出。現貨放送的狀態。可用的值如下： ACTIVE FAILED RUNNING ACTION_REQUIRED

如要查看購物內容版本，請參閱 LiaCountrySettings 和 LiaOmnichannelExperience。

取餐

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
(不適用)	(不適用)	uri	string	到店取貨產品頁面 URI。如果已設定物件，則為必填欄位。這個 API 只會用於檢查提貨服務。這個 URI 網域應與商家首頁相符。
LiaInventorySettings.status	string	state	enum (ReviewState.State)	僅供輸出。取貨服務的狀態。可用的值如下： ACTIVE FAILED RUNNING

如要查看購物內容版本，請參閱 LiaCountrySettings 和 LiaOmnichannelExperience。

LfpLink

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
posDataProviderId	string	lfpProvider	string	必要欄位。LFP 供應器的資源名稱
posExternalAccountId	string	externalAccountId	string	必要欄位。LFP 供應商知道這位商家帳戶 ID
(不適用)	(不適用)	state	enum (ReviewState.State)	僅供輸出。LfpLink 的狀態。可用的值如下： ACTIVE RUNNING

如要查看購物內容版本，請參閱 LiaPosDataProvider。

OnDisplayToOrder

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
shippingCostPolicyUrl	string	uri	string	必要欄位。「可訂購的展示商品」(ODO) 政策 URI。
status	string	state	enum (ReviewState.State)	僅供輸出。URI 的狀態。可能的值包括： ACTIVE FAILED RUNNING

如要查看購物內容版本，請參閱 LiaOnDisplayToOrderSettings。

關於

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
url	string	uri	string	必要欄位。簡介頁面 URI
status	string	state	enum (ReviewState.State)	僅供輸出。URI 的狀態。可能的值包括： ACTIVE FAILED RUNNING

如要查看購物內容版本，請參閱 LiaAboutPageSettings。

InventoryVerification

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
status	string	state	enum (InventoryVerification.State)	僅供輸出。商品目錄驗證程序的狀態。可能的值包括： ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	必要欄位。商品目錄驗證程序的聯絡人姓名
inventoryVerificationContactEmail	string	contactEmail	string	必要欄位。商品目錄驗證程序的聯絡人電子郵件地址
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	僅供輸出。聯絡人驗證狀態。可能的值包括： ACTIVE RUNNING

如要查看購物內容版本，請參閱 LiaCountrySettings 和 LiaInventorySettings。

LfpProvider

Shopping Content API		Merchant API
欄位	類型	欄位	類型	說明
fullName	string	name	string	LFP 提供者的資源名稱。 格式：accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(不適用)	(不適用)	regionCode	string	必要欄位。CLDR 國家/地區代碼
providerId	string	(不適用)	(不適用)	這個欄位就會消失。
displayName	string	displayName	string	LFP 供應器的顯示名稱

如要查看購物內容版本，請參閱 PosDataProvidersPosDataProvider。

GbpAccount

Shopping Content API		Merchant API
Field	Type	欄位	類型	說明
name	string	name	string	英鎊帳戶的資源名稱 格式： accounts/{account}/gbpAccount/{gbp_account}
(不適用)	(不適用)	gbpAccountId	string	商家檔案的 ID
type	string	type	enum (GbpAccount.Type)	商家檔案的類型。可用的值如下： USER (個人帳戶) BUSINESS_ACCOUNT (商家帳戶)
email	string	gbpAccountName	string	商家檔案名稱： 如果是個人帳戶，則為擁有者的電子郵件 ID。 如果是企業帳戶，則是商家帳戶名稱。
listingCount	string	listingCount	int64	與此帳戶相關聯的商家資訊數量

如要查看 Shopping 內容版本，請參閱 GmbAccountsGmbAccount。