從 Content API for Shopping 遷移運送設定

ShippingSettings 資源可讓您擷取及更新帳戶和所有相關聯子帳戶的運送設定。如要進一步瞭解如何新增或管理帳戶的運送設定，請參閱「運送設定簡介」。

如要使用 Merchant API 讀取運送設定資訊，請使用下列要求：

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

將 {accountId} 替換為 Merchant Center 帳戶的專屬 ID。

如要使用 Merchant API 更新運送設定資訊，請使用下列要求：

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

詳情請參閱「方法：accounts.shippingSettings.insert」。

Content API for Shopping 與 Merchant API 的比較

以下是 Content API for Shopping 與 Merchant Shipping settings API 的比較範例：

	Content API	Merchant API
網址	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
ID	{accountId}/shippingsettings/{accountId}	{name}

以下列表列出 Merchant Shipping 設定 API 與 Content API for Shopping 的重大更新：

1. Merchant API 使用者必須將 accounts/{accountId}/shippingSettings 放入 {name} 欄位，才能獲得相同的行為。
2. Merchant API 不支援自訂區域 (例如地點群組) 的讀取和寫入作業。您只能使用區域服務讀取或寫入地區群組等自訂區域。
3. 設定 WarehouseBasedDeliveryTime 的方式會因 Merchant API 和 Content API for Shopping 而異。如果您使用 Merchant API，必須在 shippingsettings.warehouses 下定義倉庫資訊。然後，每個運送服務都可以透過 warehouseBaseDeliveryTime 底下的倉庫名稱參照倉庫。
4. Merchant API 中的單一服務可支援多個運送國家/地區。

新支援的欄位

與 Content API for Shopping 相比，Merchant Shipping settings API 支援下列新欄位：

1. 倉庫：提供出貨倉庫的相關資訊，用於儲存及處理商品目錄。
2. 會員方案：Merchant API 使用者可以在運送設定中輸入會員方案資訊。
3. Etag：當不同使用者同時嘗試使用 Merchant API 和 Merchant Center UI 更新運送設定時，Etag 可用於解決非同步問題。

已重新命名的欄位

Merchant API 已重新命名下列欄位：

Content API for Shopping	Merchant Shipping settings API	說明
service	services	單一運送服務。
service.name	services.serviceName	服務的自由格式名稱，必須在 Merchant Center 帳戶中不重複。
service.deliveryCountry	services.deliveryCountries	運送服務適用的國家/地區 CLDR 地域代碼。
service.currency	services.currencyCode	這項服務適用的貨幣 CLDR 代碼。
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	訂單運送所需的最短工作天數。舉例來說，0 代表當天到貨，1 代表次日到貨。
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	訂單在運送過程中所需的最長工作天數。
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	訂單出貨前所需的最少工作天數。
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	訂單出貨前所需的工作天數上限。
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	截止時間的時區 ID。
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	郵遞區號群組的名稱。
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	產品的運送時間標籤。
service.rate_group	services.rateGroups	運送費率群組定義。
service.rate_group.subtable	services.rateGroups.subtables	子表格的清單。
service.rate_group.carrier_rate	services.rateGroups.carrierRates	電信業者費率清單。
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	共用相同最低訂單價值的商店代碼組合清單。

已淘汰的方法

您無法使用 shippingsettings.custombatch 在單一要求中擷取及更新多個帳戶的運送設定。

已不適用的欄位

下列 Content API 欄位已淘汰，不再支援。Merchant API 不會提供這些欄位的替代值。

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

方法

以下比較 Content API for Shopping 和 Merchant Shipping settings API 中的各項方法：

方法	Content API for Shopping	Merchant API
customBatch	是	否
get	是	是
update	是	否
insert	否	是
getSupportedCarrier	是	否
getSupportedHolidays	是	否