ShippingSettings
敬上
資源可讓您擷取及更新帳戶的運送設定。
Google 可以自動更新部分產品的預估送達時間。 詳情請參閱啟用自動 加以改善
讀取、寫入或更新運送設定
如要使用 Merchant API 運送服務,請按照下列步驟操作:
- 提出
GET
要求,擷取完整的運送設定 讓他們使用服務帳戶 - 修改運送設定。
- 使用修改後的運送設定提出
INSERT
要求。
ETag
Etag 為編碼符記,以避免非同步更新。ETag 會在
任何運送設定資料的變更。使用者必須複製 ETag
從 GET
要求取得 INSERT
要求主體。
如果 GET
要求和 INSERT
之間的運送設定資料有所變更
要求,您收到一則錯誤訊息,要求再次提出 GET
要求
擷取最新的 Etag 權杖您必須呼叫 GET
要求,才能:
擷取新的 etag 權杖,並將新的 etag 權杖複製到 INSERT
要求
新增運送設定
使用 shippingsettings.insert
新增或更新
讓他們使用服務帳戶以下要求範例將 maxTransitDays
更新為 7,
名為「GSA Shipping - 免運費」運費,金額超過 $49.99 美元
10.
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/
{
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountries": ["US"],
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 4,
"maxTransitDays": 6,
"minHandlingDays": 0,
"maxHandlingDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 5990000,
"currencyCode": "USD"
}
},
"name": "All products"
}
]
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountries": "US",
"currencyCode": "USD",
"deliveryTime": {
"minTransitDays": 3,
"maxTransitDays": 7,
"minHandlingDays": 1,
"maxHandlingDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"amountMicros": 49990000,
"currencyCode": "USD"
},
{
"amountMicros": -1,
"currencyCode": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"amountMicros": 6990000,
"currencyCode": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
]
}
]
}
組合倉庫
以下 JSON 範例說明如何使用「商家運送」設定 服務來管理商家帳戶的倉儲資訊:
"warehouses": [
{
"name": "warehouse 1",
"shippingAddress": {
"streetAddress": {street_address},
"city": {city},
"administrativeArea": {administrative_area},
"postalCode": {postal_code},
"regionCode": {region_code}
},
"cutoffTime": {
"minutes": {minutes}
},
"handlingDays": {handling_days},
"businessDaysConfig": {
"businessDays": [
"MONDAY", "SUNDAY"
]
}
}
]
更改下列內容:
- {street_address}:倉庫地址的街道層級部分。
- {city}:倉庫所在的城市、鄉鎮或行政區。
- {administrative_area}: 國家。例如,州/省行政區。
- {postal_code}:郵遞區號或郵遞區號。
- {region_code}:字串中的國家/地區代碼。
- {minutes}:在截止時間中, 訂單必須提交於倉庫的同一天內處理。
- {handling_days}:完成這項操作所需的天數 用於包裝及運送商品。
warehouses
資源是倉儲清單。每個倉儲可以
是經由運送服務的倉庫出貨時間所衍生的
warehouse.name
。
管理倉庫
以下說明如何使用 Merchant API 管理倉庫:
- 發出
GET
要求,擷取所有現有shippingsettings
和 倉儲系統 將
shippingsettings
從GET
要求複製到UPDATE
要求。填入您想在
warehouses
區段中使用的倉庫 針對INSERT
要求。提出包含
shippingsettings
和warehouses
的UPDATE
要求 再複習一下,機構節點 是所有 Google Cloud Platform 資源的根節點
以下是已更新倉庫的 INSERT
要求主體範例:Warehouse 1
從紐約到山景城:
{
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountries": ["US", "UK"],
"currencyCode": "USD",
"deliveryTime": {
"minHandlingDays": 0,
"maxHandlingDays": 1,
"warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
"carrierService": "ground"
"warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
"carrierService": "2 days"
"warehouse": "Warehouse 2"
}
]
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
},
"name": "Standard Shipping"
}
],
},
{
"name": "Expedited",
"flatRate": {
"amountMicros": 9990000,
"currencyCode": "USD"
}
},
"name": "Expedited"
}
],
}
],
"warehouses": [
{
"name": "Warehouse1",
"shippingAddress": [
{
"streetAddress": "1111 shoreline street"
"city": "Mountain View",
"administrativeArea": "CA"
}
]
},
{
"name": "Warehouse 2",
"country": "US",
"postalCodeRanges": [
{
"streetAddress": "1111 5th avenue"
"city": "New York",
"administrativeArea": "NY"
}
]
}
]
}
新增當天到貨服務
你可以使用 Content API for Shopping 設定當天到貨服務
提供店面商品目錄資料當天到貨運送服務設有
local_delivery
做為shipment_type
。所有運費:local_delivery
所有服務都會視為當天到貨。
你無法變更本地配送的delivery_time
資訊。使用
如要為店面商品目錄設定當天到貨服務,請shippingsettings.insert
很少直接解答該如何打造產品
以下這個要求主體範例為所有商店新增當天到貨服務 帳戶:
{
"name": "accounts/accountId/shippingSettings",
"services": [
{
"name": "Local Delivery",
"active": true,
"shipmentType": "local_delivery",
"deliveryCountries": "US",
"currencyCode": "USD",
"rateGroups": [
{
"singleValue": {
"flatRate": {
"amountMicros": 0,
"currencyCode": "USD"
}
}
}
],
"storeConfig": {
"storeServiceType": "all stores",
"storeCodes": [],
"cutoffConfig": {
"storeCloseOffsetHours": 2,
"noDeliveryPostCutoff": true
},
"serviceRadius": {
"value": 4,
"unit": "Miles"
}
}
}
]
}
新增次日到貨服務
當天到貨截止時間後下單的訂單,已排定在下一次
日到貨。如要關閉次日到貨服務,請將
no_delivery_post_cutoff
欄位設為 true。如果關閉「次日到貨」服務,您的
運送服務必須在每日截止時間之前顯示。
只有在shipment_type
的運送時間為
local_delivery
。
瞭解詳情
如要瞭解如何從 Content API for Shopping 遷移,請參閱遷移運送資訊 設定管理。