- 資源:ShippingSettings
- 服務
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- 平日
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- 資料表
- 標頭
- 重量
- WeightUnit
- LocationIdSet
- 列
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- 距離
- 單位
- LoyaltyProgram
- LoyaltyProgramTiers
- 倉庫
- 地址
- WarehouseCutoffTime
- 方法
資源:ShippingSettings
商家帳戶的運送設定。
JSON 表示法 |
---|
{ "name": string, "services": [ { object ( |
欄位 | |
---|---|
name |
ID。運送設定的資源名稱。格式: |
services[] |
選用設定。目標帳戶的服務清單。 |
warehouses[] |
選用設定。可在 |
etag |
必要欄位。這個欄位可用於避免非同步問題。請確認在呼叫 get 和插入呼叫之間,運送設定資料不會變更。使用者應採取下列步驟:
|
服務
運送服務。
JSON 表示法 |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
欄位 | |
---|---|
delivery |
必要欄位。服務適用的國家/地區 CLDR 地域代碼。 |
rate |
選用設定。運送費率群組定義。只有最後一個群組可以有空白的 |
loyalty |
選用設定。這項運送服務僅適用於哪些會員方案? |
service |
必要欄位。服務的自由格式名稱。在目標帳戶中不得重複。 |
active |
必要欄位。布林值,用於公開運送服務的有效狀態。 |
currency |
這項服務適用的貨幣 CLDR 代碼。必須與費率群組中的價格相符。 |
delivery |
必要欄位。從下單到產品送達,各個環節所需的時間。 |
shipment |
這項服務運送訂單的地區類型。 |
minimum |
這項服務的最低訂單價值。如果已設定,表示顧客必須至少消費這個金額。服務中的所有價格都必須使用相同的貨幣。無法與 minimumOrderValueTable 一起設定。 |
minimum |
下表列出自取出貨類型每間商店的最低訂單價值。無法與 minimumOrderValue 一併設定。 |
store |
產品運送商店清單。這項功能僅適用於店面運送貨件類型。 |
DeliveryTime
從下單到產品送達,各個環節所需的時間。
JSON 表示法 |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
欄位 | |
---|---|
warehouse |
選用設定。表示系統應根據所選貨運公司的設定,為每個倉庫 (運送原點位置) 計算送達時間。設定後,[delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應再設定其他運送時間相關欄位。 |
min |
運送過程中所需的最短工作天數。0 代表當天到貨,1 代表次日到貨。必須設定 |
max |
運送過程中所需的最長工作天數。0 代表當天到貨,1 代表次日到貨。必須大於或等於 |
cutoff |
工作天截止時間定義。如果未設定,截止時間預設為太平洋標準時間上午 8 點。 |
min |
訂單出貨前所需的最少工作天數。0 代表當天出貨,1 代表次日出貨。請同時設定或不設定「minHandlingDays」和「maxHandlingDays」。 |
max |
訂單出貨前所需的最大工作天數。0 代表當天出貨,1 代表次日出貨。必須大於或等於 |
transit |
運送時間表格:根據列和欄維度,計算運送所需的工作天數。您可以設定 |
handling |
訂單可處理的工作天數。如未提供,系統會假設週一至週五為工作日。 |
transit |
訂單可能處於運送中的工作天數。如未提供,系統會假設週一至週五為工作日。 |
CutoffTime
工作天截止時間定義。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
欄位 | |
---|---|
hour |
必要欄位。截止時間的指定小時,訂單必須在截止時間前下單,才能在當天處理。 |
minute |
必要欄位。訂單截止時間的最後幾分鐘,訂單必須在這個時間前下單,才能在當天處理。 |
time |
必要欄位。時區 ID,例如「Europe/Zurich」。 |
TransitTable
運送時間表格:根據列和欄維度,計算運送所需的工作天數。您可以設定 minTransitDays
、maxTransitDays
或 transitTimeTable
,但不能同時設定兩者。
JSON 表示法 |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
欄位 | |
---|---|
postal |
必要欄位。區域名稱清單 |
transit |
必要欄位。運送時間標籤清單。最後一個值可以是 |
rows[] |
必要欄位。如果只有一個 |
TransitTimeRow
如果只有一個 postalCodeGroupNames
或 transitTimeLabels
維度集,則會有多個資料列,每個資料列都包含該維度的一個值。如果有兩個維度,每個資料列都會對應至 postalCodeGroupNames
,而資料欄 (值) 則會對應至 transitTimeLabels
。
JSON 表示法 |
---|
{
"values": [
{
object ( |
欄位 | |
---|---|
values[] |
必要欄位。運送時間範圍 (最小至最大),以工作天為單位。 |
TransitTimeValue
運送時間範圍 (最小至最大),以工作天為單位。
JSON 表示法 |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
欄位 | |
---|---|
min |
最短運送時間範圍 (以工作天為單位)。0 代表當天到貨,1 代表次日到貨。 |
max |
必須大於或等於 |
BusinessDayConfig
倉庫的工作天。
JSON 表示法 |
---|
{
"businessDays": [
enum ( |
欄位 | |
---|---|
business |
必要欄位。正常營業日。不得留空。 |
平日
列舉 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
表示系統應根據所選貨運公司的設定,為每個倉庫 (運送原點位置) 計算送達時間。設定後,deliveryTime
中不得再設定其他與運送時間相關的欄位。
JSON 表示法 |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
欄位 | |
---|---|
carrier |
必要欄位。載具,例如 |
carrier |
必要欄位。電信服務,例如 |
warehouse |
必要欄位。倉儲名稱。這個值應與 [warehouse][ShippingSetting.warehouses.name] 相符 |
RateGroup
運送費率群組定義。只有最後一個群組可以有空白的 applicableShippingLabels
,代表「其他所有」群組。其他 applicableShippingLabels
不得重疊。
JSON 表示法 |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
欄位 | |
---|---|
applicable |
必要欄位。運送標籤清單,定義這個費率群組適用的產品。這是一個選項:只要任一標籤相符,系統就會套用費率群組。只有服務的最後一個費率群組可以為空白。 |
subtables[] |
選用設定。 |
carrier |
選用設定。可由 |
single |
費率群組的值 (例如 $10 美元的固定費率)。只有在未設定 |
main |
當 |
name |
選用設定。費率群組名稱。在運送服務中不得重複。 |
值
費率群組的單一值,或費率群組表格儲存格的值。必須明確設為 noShipping
、flatRate
、pricePercentage
、carrier_rateName
或 subtable_name
其中之一。
JSON 表示法 |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
欄位 | |
---|---|
no |
如果為 true,則表示產品無法運送。設定時必須設為 true,且只能在所有其他欄位未設定的情況下設定。 |
flat |
固定費率。只有在所有其他欄位未設定時,才能設定此欄位。 |
price |
以小數表示的價格百分比 (例如 |
carrier |
運送公司費率的名稱,指的是同一個費率群組中定義的運送公司費率。只有在所有其他欄位未設定時,才能設定此欄位。 |
subtable |
子表格的名稱。只能在表格儲存格中設定 (例如,不能用於單一值),且只有在所有其他欄位都未設定的情況下才能設定。 |
資料表
當 singleValue
無法充分表達時,定義費率群組的表格。
JSON 表示法 |
---|
{ "rows": [ { object ( |
欄位 | |
---|---|
rows[] |
必要欄位。構成資料表的資料列清單。必須與 |
name |
資料表名稱。子表格必填,主表格則忽略。 |
row |
必要欄位。表格列的標題。 |
column |
表格欄的標題。選用:如果未設定,則資料表只有一個維度。 |
標頭
表格的資料列或欄標題非空白清單。必須設定 prices
、weights
、num_items
、postalCodeGroupNames
或 location
其中一個值。
JSON 表示法 |
---|
{ "prices": [ { object ( |
欄位 | |
---|---|
prices[] |
必要欄位。包含訂單價格上限的清單。只要將 price amountMicros 設為 -1,最後價格的值就能設為無限。例如 |
weights[] |
必要欄位。包含訂單重量上限的清單。只要將 price amountMicros 設為 -1,最後一個權重值就能設為無限。例如 |
number |
必要欄位。包含項目上限數量的清單。最後一個值可以是 |
postal |
必要欄位。郵政區域名稱清單。最後一個值可以是 |
locations[] |
必要欄位。地區 ID 集合的清單。不得空白。只有在所有其他欄位未設定時,才能設定此欄位。 |
重量
以字串和單位表示的值。
JSON 表示法 |
---|
{
"unit": enum ( |
欄位 | |
---|---|
unit |
必要欄位。重量單位。可接受的值為:kg 和 lb |
amount |
必要欄位。以百萬分之一表示的重量 (1 百萬百萬分之一等於 1 個貨幣標準單位,例如 1 公斤 = 1000000 百萬分之一)。您也可以將這個欄位設為 -1,以便設定無限值。這個欄位僅支援 -1 和正值。 |
WeightUnit
重量單位。
列舉 | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
未指定單位 |
POUND |
磅。 |
KILOGRAM |
公斤。 |
LocationIdSet
地區 ID 集合的清單。不得空白。只有在所有其他欄位未設定時,才能設定此欄位。
JSON 表示法 |
---|
{ "locationIds": [ string ] } |
欄位 | |
---|---|
location |
必要欄位。非空白的地區 ID 清單。這些位置都必須屬於相同的位置類型 (例如州/省)。 |
列
請附上儲存格清單。
JSON 表示法 |
---|
{
"cells": [
{
object ( |
欄位 | |
---|---|
cells[] |
必要欄位。組成該列的儲存格清單。必須與 |
CarrierRate
可由 mainTable
或 singleValue
參照的電信費率清單。支援的運送服務定義請參閱 https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only。
JSON 表示法 |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
欄位 | |
---|---|
name |
必要欄位。運送業者費率的名稱。每個費率群組的名稱皆不得重複。 |
carrier |
必要欄位。電信服務,例如 |
carrier |
必要欄位。電信服務,例如 |
origin |
必要欄位。這個運送公司費率的運送起點。 |
percentage |
選用設定。以小數表示的運費乘數。可為負數。例如 |
flat |
選用設定。加總運費調節係數。可為負數。舉例來說, |
ShipmentType
運送服務的貨件類型。
列舉 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
這項服務未指定運送類型。 |
DELIVERY |
這項服務會將訂單運送至消費者選擇的地址。 |
LOCAL_DELIVERY |
這項服務會將訂單運送至消費者選擇的地址。訂單會從附近的當地商店出貨。 |
COLLECTION_POINT |
這項服務會將訂單運送至消費者選擇的地址。訂購商品會從集貨地點出貨。 |
MinimumOrderValueTable
下表列出自取出貨類型每間商店的最低訂單價值。
JSON 表示法 |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
欄位 | |
---|---|
store |
必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼組合清單。至少需要兩個集合,且最後一個集合必須為空白,代表「MOV for all other stores」。每個商家代碼只能出現在所有集合中一次。服務中的所有價格都必須使用相同的貨幣。 |
StoreCodeSetWithMov
共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合,且最後一個集合必須為空白,代表「MOV for all other stores」。每個商家代碼只能出現在所有集合中一次。服務中的所有價格都必須使用相同的貨幣。
JSON 表示法 |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
欄位 | |
---|---|
store |
選用設定。清單內含專屬商店代碼,或空白 (用於萬用)。 |
value |
指定商店的最低訂單價值。 |
StoreConfig
產品運送商店清單。這項功能僅適用於店面運送貨件類型。
JSON 表示法 |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
欄位 | |
---|---|
store |
選用設定。提供當地運送服務的商店代碼清單。如果為空白,則 |
store |
指出商家列出的所有商店或特定商店是否提供當地運送服務。 |
cutoff |
當天結束的本機提交相關設定。 |
service |
最大運送範圍半徑。這項屬性僅適用於店面運送貨件類型。 |
StoreServiceType
指出商家列出的所有商店或特定商店是否提供當地運送服務。
列舉 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
未指定商店服務類型。 |
ALL_STORES |
指出商家目前和未來列出的所有商店是否提供本地運送服務。 |
SELECTED_STORES |
表示只有 storeCodes 中列出的商店符合店面運送資格。 |
CutoffConfig
當天結束的本機提交相關設定。
JSON 表示法 |
---|
{
"localCutoffTime": {
object ( |
欄位 | |
---|---|
local |
當天店面到貨服務結束的時間。 |
store |
僅適用於當地出貨服務。以商店打烊前幾小時的數量代表截止時間。與 |
no |
如果商家已將運送服務設為 n 天店到店運送,就能選擇不顯示 n+1 天店到店運送服務。舉例來說,如果運送服務定義為當天到貨,且已超過截止時間,將這個欄位設為 |
LocalCutoffTime
當天店面到貨服務結束的時間。
JSON 表示法 |
---|
{ "hour": string, "minute": string } |
欄位 | |
---|---|
hour |
當天處理的店到店配送訂單必須在指定時間前下單。 |
minute |
訂單必須在當天處理的訂單截止時間前下單,才能在當天處理。 |
距離
最大運送範圍半徑。這項屬性僅適用於店面運送貨件類型。
JSON 表示法 |
---|
{
"value": string,
"unit": enum ( |
欄位 | |
---|---|
value |
距離的整數值。 |
unit |
單位可能因國家/地區而異,但參數會包含英里和公里。 |
單位
單位可能因國家/地區而異,但參數會包含英里和公里。
列舉 | |
---|---|
UNIT_UNSPECIFIED |
未指定單位 |
MILES |
以英里為單位 |
KILOMETERS |
以公里為單位 |
LoyaltyProgram
商家提供的會員方案。
JSON 表示法 |
---|
{
"loyaltyProgramTiers": [
{
object ( |
欄位 | |
---|---|
loyalty |
選用設定。這項運送服務的會員方案等級。 |
program |
你在 Merchant Center 會員方案中所設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。 |
LoyaltyProgramTiers
商家會員方案的子集。
JSON 表示法 |
---|
{ "tierLabel": string } |
欄位 | |
---|---|
tier |
會員等級標籤 [tierLabel] 子屬性可用於區分不同會員等級的商品層級福利。你也會在 Merchant Center 會員方案中設定這項屬性值;即使會員方案只有 1 個等級,變更資料來源時你也必須提供這個屬性值。 |
Warehouse
出貨倉庫,用於儲存及處理商品目錄。
JSON 表示法 |
---|
{ "name": string, "shippingAddress": { object ( |
欄位 | |
---|---|
name |
必要欄位。倉庫名稱。在帳戶中不得重複。 |
shipping |
必要欄位。倉庫的運送地址。 |
cutoff |
必要欄位。訂單可接受及開始處理的最後時間。後續訂單會在隔天處理。時間會根據倉庫的郵遞區號計算。 |
handling |
必要欄位。這個倉庫裝箱及出貨商品所需的天數。這是在倉庫層級,但可以根據商品屬性,在商品層級覆寫。 |
business |
倉庫的工作天數。如果未設定,預設值為週一至週五。 |
地址
倉庫的運送地址。
JSON 表示法 |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
欄位 | |
---|---|
street |
地址的街道層級部分。例如 |
city |
必要欄位。城市、鄉鎮或社區。也可能包含從屬地區或次區域 (例如社區或郊區)。 |
administrative |
必要欄位。國家/地區的最上層行政區劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。 |
postal |
必要欄位。郵遞區號 (例如「94043」)。 |
region |
必要欄位。CLDR 國家/地區代碼 (例如「US」)。 |
WarehouseCutoffTime
訂單可接受及開始處理的最後時間。後續訂單會在隔天處理。時間會根據倉庫的郵遞區號計算。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer } |
欄位 | |
---|---|
hour |
必要欄位。截止時間的指定小時,即訂單必須在截止時間前下單,才能在當天由倉庫處理。小時以倉庫所在的時區為準。 |
minute |
必要欄位。截止時間的最後幾分鐘,訂單必須在這個時間前下單,才能在當天由倉庫處理。分鐘是根據倉庫的時區計算。 |
方法 |
|
---|---|
|
擷取運送設定資訊。 |
|
將商家的運送設定替換為要求運送設定。 |