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

如果您曾使用 Shopping Content API 的店面商品目錄廣告設定，請注意 Merchant API 有幾項重大變更。

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

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

此外，店面商品目錄廣告設定中，每個帳戶只有一項資源，其中包含各國家/地區實體的設定清單。透過 OmnichannelSettings，您可以將多項資源與一個帳戶建立關聯。每項資源代表特定國家/地區實體的設定。

以下是要求和資源的變更。

要求

新網域	Content API 方法名稱	Merchant API 方法名稱
accounts.omnichannelSettings	liasettings.custombatch	這個方法即將淘汰。Merchant API 支援一次傳送多項要求的功能。
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	無法再直接取得所有子帳戶的店面商品目錄廣告設定。請改為查詢所有子帳戶，並使用 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
  • 取餐
  • LfpLink
  • OnDisplayToOrder
  • 關於
  • InventoryVerification
• LfpProvider
• GbpAccount

此外，這項服務對 PickupType 的行為也不同。請參閱「Pickup」。

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的 本地店面 (LSF) 類型。可能的值包括 GHLSF (Google 代管的本地店面) MHLSF_BASIC (商家代管的本地店面基本版，即提供店內供應情形的產品頁面) MHLSF_FULL (商家代管的本地店面完整版，即提供店內供應情形的產品頁面)
(不適用)	(不適用)	inStock	object (InStock)	這個regionCode的有現貨產品頁面 URI (統一資源識別碼) 和供應情形。如果您選擇其中一種 MHLSF 類型，請在建立 API 中設定至少一個 inStock 或 pickup 物件，但如果 lsfType 為 GHLSF，則只能設定 inStock。
storePickupActive	boolean	pickup	object (Pickup)	這個regionCode的取貨產品頁面 URI 和放送狀態。如果您選擇其中一種 MHLSF 類型，請在建立 API 中設定至少一個 inStock 或 Pickup 物件，但如果 GHLSF 設為 lsfType，則請勿設定。
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	Google 商家檔案帳戶的資源名稱 格式： 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	與這個帳戶相關聯的產品資訊數量

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