ShippingSettings
資源可讓您擷取及更新帳戶和所有相關聯子帳戶的運送設定。如要進一步瞭解如何新增或管理帳戶的運送設定,請參閱「運送設定簡介」。
如要使用 Merchant API 讀取運送設定資訊,請使用下列要求:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/shippingSettings
將 {ACCOUNT_ID} 替換為 Merchant Center 帳戶的專屬 ID。
如要使用 Merchant API 更新運送設定資訊,請使用下列要求:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/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/ {ACCOUNT_ID}/shippingsettings:insert |
https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {ACCOUNT_ID}/shippingSettings:insert |
ID | {ACCOUNT_ID}/shippingsettings/ {ACCOUNT_ID} |
{NAME} |
以下列表列出 Merchant Shipping 設定 API 與 Content API for Shopping 的重大更新:
- Merchant API 使用者必須將
accounts/{ACCOUNT_ID}/shippingSettings
放入 {NAME} 欄位,才能獲得相同的行為。 - Merchant API 不支援自訂區域 (例如地點群組) 的讀取和寫入作業。您只能使用區域服務讀取或寫入地區群組等自訂區域。
- 設定
WarehouseBasedDeliveryTime
的方式會因 Merchant API 和 Content API for Shopping 而異。如果您使用 Merchant API,必須在shippingsettings.warehouses
下定義倉庫資訊。然後,每個運送服務都可以透過warehouseBaseDeliveryTime
底下的倉庫名稱參照倉庫。 - Merchant API 中的單一服務可支援多個運送國家/地區。
新支援的欄位
與 Content API for Shopping 相比,Merchant Shipping settings API 支援下列新欄位:
- 倉庫:提供出貨倉庫的相關資訊,用於儲存及處理商品目錄。
- 會員方案:商家 API 使用者可以在運送設定中輸入會員方案資訊。
- 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 中淘汰。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 |
是 | 否 |