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

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

店面商品目錄廣告設定現在屬於三個核心元件之一，每個元件都有相關聯的資源。

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

資源

此外，服務的運作方式會因 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 的 本地店面 (LSF) 類型。 可能的值包括
  • GHLSF (Google 代管的本地店面)
  • MHLSF_BASIC (商家代管的本地店面基本版，是指提供店內供應情形的產品頁面)
  • MHLSF_FULL (商家代管的本地店面完整版，也就是提供店內供應情形的產品頁面)
(不適用) (不適用) inStock object
(InStock)		 這項 regionCode 的有現貨產品頁面 URI (統一資源識別碼) 和放送狀態。如果您選擇 MHLSF 類型，請在建立 API 中設定至少一個 inStock 或 pickup 物件，但如果 lsfType 為 GHLSF，則只能設定 inStock。
storePickupActive boolean pickup object
(Pickup)		 這項產品的自取產品頁面 URI 和放送狀態。regionCode如果您選擇 MHLSF 類型，請在建立 API 時設定至少一個 inStock 或 Pickup 物件，但如果 GHLSF 設為 lsfType，則請勿設定。
posDataProvider object
(LiaPosDataProvider)		 lfpLink object
(LfpLink)		 僅供輸出。與 LFP 供應商建立的連結
onDisplayToOrder object
(LiaOnDisplayToOrderSettings)		 odo object
(OnDisplayToOrder)		 這項regionCode的「可訂購的展示商品」政策 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。

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 必填。「可訂購的展示商品」政策 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 與這個帳戶相關聯的商家資訊數量

如要查看 Shopping Content 版本，請參閱「GmbAccountsGmbAccount」。

上一頁
Migrate local feeds partnership management
下一頁
Migrate online return policy management