從 Content API for Shopping 遷移運送設定

ShippingSettings敬上 資源可讓您擷取與更新帳戶的運送設定 所有相關聯的子帳戶如要進一步瞭解如何 新增或管理帳戶的運送設定，請參閱運送總覽 設定。

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

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

將 {accountId} 替換為以下項目的專屬 ID： Merchant Center 帳戶：

如要透過 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 與商家的差異範例 運送設定 API：

	Content API	商家 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 Settings API 的重大更新 相較於 Content API for Shopping：

1. Merchant API 使用者必須將 accounts/{accountId}/shippingSettings 放入 {name} 欄位，才能具有相同行為。
2. Merchant API 不支援對自訂區域 (例如 建立為營業地點群組自訂區域 (例如地區群組) 只能讀取或 使用區域服務編寫而成
3. WarehouseBasedDeliveryTime 的設定方式 和 Content API for Shopping 並不相同。如果發生以下情況： 使用 Merchant API 時，您必須在以下位置定義倉儲資訊： shippingsettings.warehouses。接著，每項運送服務都能透過 倉庫名稱是 warehouseBaseDeliveryTime。
4. Merchant API 中的一項服務支援多個運送國家/地區。

新的支援欄位

相較於下列產品，Merchant Shipping Settings API 支援下列新欄位： Content API for Shopping：

1. 倉庫：提供出貨倉庫相關資訊。 用於儲存及處理商品目錄
2. 會員方案：Merchant API 使用者可輸入會員方案資訊來 運費設定
3. Etag：Etag 的用途是解決不同使用者嘗試 請前往下列網址，使用 Merchant API 和 Merchant Center UI 更新運送設定：

已重新命名欄位

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

Content API for Shopping	商家運送設定 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 中已淘汰。商家 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 和 商家運送設定 API：

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