ShippingSettings

商家帳戶的 [運送設定](https://support.google.com/merchants/answer/6069284)。

JSON 表示法 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
欄位
name

string

ID。運送設定的資源名稱。格式：accounts/{account}/shippingSetting
services[]

object (Service)

選用設定。目標帳戶的服務清單。
warehouses[]

object (Warehouse)

選用設定。可在 services 中參照的倉庫清單。
etag

string

必要欄位。這個欄位可用於避免發生非同步問題。確認來電設定資料在接到來電與插入來電的時間不會改變。使用者必須執行下列步驟：

  1. 將 etag 欄位設為空白字串，以建立初始運送設定。

  2. 首次建立後，請呼叫 get 方法，在呼叫插入之前取得 eTag 和目前的運送設定資料。

  3. 想修改運送設定資訊。

  4. 使用步驟 2 取得的 etag 呼叫 insert 方法，並提供所需的運送設定資訊。

  5. 如果運送設定資料在步驟 2 到步驟 4 之間出現變動，每當運送設定資料變更時，eTag 就會變更，插入要求會失敗。使用者應使用新的 eTag 重複步驟 2 到 4。

服務

運送服務。

JSON 表示法 
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
欄位
deliveryCountries[]

string

必要欄位。服務適用國家/地區的 CLDR 地域代碼。
rateGroups[]

object (RateGroup)

選用設定。運送費率群組定義。只有最後一個項目可以含有空白的 applicableShippingLabels，表示「其他」。其他applicableShippingLabels不得重疊。
loyaltyPrograms[]

object (LoyaltyProgram)

選用設定。這項運送服務僅適用於特定會員方案。
serviceName

string

必要欄位。服務名稱 (形式不拘)，在目標帳戶中不得重複。
active

boolean

必要欄位。顯示運送服務有效狀態的布林值。
currencyCode

string

這項服務所適用貨幣的 CLDR 代碼。費率群組中的價格必須一致。
deliveryTime

object (DeliveryTime)

必要欄位。從訂購到產品出貨等各個面向所花費的時間。
shipmentType

enum (ShipmentType)

這項服務能運送訂單的目標地點類型。
minimumOrderValue

object (Price)

這項服務的最低訂單價值。指定時，表示客戶必須至少支付這個金額。一項服務中的所有價格都必須採用相同幣別。無法與 minOrderValueTable 一起設定。
minimumOrderValueTable

object (MinimumOrderValueTable)

取貨配送類型的個別商店最低訂單值表格。無法與 minOrderValue 一起設定。
storeConfig

object (StoreConfig)

產品的運送來源清單。這只適用於本地運送運送類型。

DeliveryTime

從訂購到產品出貨等各個面向所花費的時間。

JSON 表示法 
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
欄位
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

選用設定。表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後，[運送時間][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應設定其他運送時間相關欄位。
minTransitDays

integer

運送過程中的最短工作天數。0 表示當天到貨服務，1 代表次日到貨。必須設定 minTransitDays、maxTransitDays 或 transitTimeTable，但不能同時設定兩者。
maxTransitDays

integer

運送過程中花費的最長工作天數。0 表示當天到貨服務，1 代表次日到貨。必須大於或等於 minTransitDays。
cutoffTime

object (CutoffTime)

「工作天」截止時間定義。如未設定，截止時間會預設為太平洋標準時間上午 8 點。
minHandlingDays

integer

訂單出貨前經過的最短工作天數。0 表示出貨當天，1 代表隔天出貨。
maxHandlingDays

integer

訂單出貨前所花費的最長工作天數。0 表示出貨當天，1 代表隔天出貨。必須大於或等於 minHandlingDays。
transitTimeTable

object (TransitTable)

運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。minTransitDays、maxTransitDays 或 transitTimeTable 都可以設定，但不能同時設定兩者。
handlingBusinessDayConfig

object (BusinessDayConfig)

訂單處理期間 (工作天)。如未提供，系統會預設採用星期一至星期五的工作天。
transitBusinessDayConfig

object (BusinessDayConfig)

訂單可出貨的工作天。如未提供，系統會預設採用星期一至星期五的工作天。

CutoffTime

「工作天」截止時間定義。

JSON 表示法 
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
欄位
hour

integer

必要欄位。訂單必須在同一天完成處理的截止時間 (小時)。
minute

integer

必要欄位。訂單必須在同一天完成處理的截止時間 (分鐘)。
timeZone

string

必要欄位。時區 ID，例如「歐洲/蘇黎世」。

TransitTable

運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。minTransitDays、maxTransitDays 或 transitTimeTable 都可以設定，但不能同時設定兩者。

JSON 表示法 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
欄位
postalCodeGroupNames[]

string

必要欄位。區域名稱清單 Region.name。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。推薦的郵遞區號群組必須與服務的運送國家/地區相符。
transitTimeLabels[]

string

必要欄位。運送時間標籤清單。最後一個值可以是 "all other labels"。例如：["food", "electronics", "all other labels"].
rows[]

object (TransitTimeRow)

必要欄位。如果只有一組維度組合 postalCodeGroupNames 或 transitTimeLabels，則會有多個資料列，每個資料列都具有一個該維度的值。如果有兩個維度，則每列都會對應到 postalCodeGroupNames，而欄 (值) 則對應到 transitTimeLabels。

TransitTimeRow

如果只有一組維度組合 postalCodeGroupNames 或 transitTimeLabels，則會有多個資料列，每個資料列都具有一個該維度的值。如果有兩個維度，則每列都會對應到 postalCodeGroupNames，而欄 (值) 則對應到 transitTimeLabels。

JSON 表示法 
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
欄位
values[]

object (TransitTimeValue)

必要欄位。運送時間範圍 (最短至最長工作天)。

TransitTimeValue

運送時間範圍 (最短至最長工作天)。

JSON 表示法 
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
欄位
minTransitDays

integer

最短運送時間範圍 (以工作天為單位)。0 表示當天到貨服務，1 代表次日到貨。
maxTransitDays

integer

必須大於或等於 minTransitDays。

BusinessDayConfig

倉庫的工作天。

JSON 表示法 
{
  "businessDays": [
    enum (Weekday)
  ]
}
欄位
businessDays[]

enum (Weekday)

必要欄位。一般工作天。不得留空。

平日

列舉
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後，deliveryTime 中不應設定其他運送時間相關欄位。

JSON 表示法 
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
欄位
carrier

string

必要欄位。電信業者，例如 "UPS" 或 "Fedex"。
carrierService

string

必要欄位。電信業者服務，例如 "ground" 或 "2 days"。服務名稱必須列於 eddSupportedServices 清單中。
warehouse

string

必要欄位。倉儲名稱。這應符合 [warehouse][ShippingSetting.warehouses.name]

RateGroup

運送費率群組定義。只有最後一個項目可以含有空白的 applicableShippingLabels，表示「其他」。其他applicableShippingLabels不得重疊。

JSON 表示法 
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
欄位
applicableShippingLabels[]

string

必要欄位。運送標籤清單，用於定義這個費率群組適用的產品。這是假造：只有其中一個標籤必須相符，系統才能套用費率群組。只有服務的最後一個費率群組可以留空。
subtables[]

object (Table)

選用設定。mainTable 參照的子表格清單。只有在設定 mainTable 時才能設定。
carrierRates[]

object (CarrierRate)

選用設定。mainTable 或 singleValue 可參照的貨運公司費率清單。
singleValue

object (Value)

費率群組的值 (例如固定費率 $10 美元)。只有在未設定 mainTable 和 subtables 時才能設定。
mainTable

object (Table)

當 singleValue 不夠明確時，定義費率群組的資料表。只有在未設定 singleValue 時才能設定。
name

string

選用設定。費率群組名稱。此設定在運送服務中不得重複。

價值

費率群組的單一值，或是費率群組表格儲存格的值。必須明確設定 noShipping、flatRate、pricePercentage、carrier_rateName、subtable_name 其中之一。

JSON 表示法 
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
欄位
noShipping

boolean

如果值為 true，產品將無法出貨。設定時必須設為 true，且只有在其他欄位皆未設定的情況下才能設定。
flatRate

object (Price)

固定費率。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
pricePercentage

string

以十進位標記法 (例如 "5.4") 表示的價格百分比。只有在其他欄位未設定的情況下，才能設定。
carrierRate

string

參照相同費率群組中定義的貨運公司費率的貨運公司費率名稱。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
subtable

string

子表格的名稱。只能在表格儲存格中設定 (例如不得為單一值)，且只有在未設定所有其他欄位的情況下才能設定。

資料表

當 singleValue 不夠明確時，定義費率群組的資料表。

JSON 表示法 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
欄位
rows[]

object (Row)

必要欄位。構成資料表的資料列清單。長度必須與 rowHeaders 相同。
name

string

資料表名稱。子資料表必填，主表格會忽略。
rowHeaders

object (Headers)

必要欄位。資料表中資料列的標題。
columnHeaders

object (Headers)

資料表中的資料欄標頭。選用：如未設定，表格就只會顯示一個維度。

標頭

表格的資料列或欄標題清單不得為空白。必須明確設定 prices、weights、num_items、postalCodeGroupNames 或 location 其中之一。

JSON 表示法 
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
欄位
prices[]

object (Price)

必要欄位。包含訂單價格上限的清單。最終價格的值可以是無限大，方法是將 price amountMicros 設為 -1。舉例來說，[{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] 代表標題「<= $10」、「<= $500"」和「"> $500 美元」。一項服務中的所有價格都必須採用相同幣別。不得空白。必須為正數，但 -1 除外。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
weights[]

object (Weight)

必要欄位。包含訂單權重上限的清單。最後一個重量的值可以是無限量，只要設定 price amountMicros = -1 即可。舉例來說，[{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] 代表標頭「<= 10kg」、「<= 50kg」和 "> 50kg」。服務內的所有重量都必須具有相同的單位。不得空白。必須為正數，但 -1 除外。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
numberOfItems[]

string

必要欄位。包含項目數量上限的清單。最後一個值可以是 "infinity"。舉例來說，["10", "50", "infinity"] 代表標題「<= 10 個項目」、「<= 50 個項目」和「> 50 個項目」。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
postalCodeGroupNames[]

string

必要欄位。郵政群組名稱清單。最後一個值可以是 "all other locations"。範例：["zone 1", "zone 2", "all other locations"]。推薦的郵遞區號群組必須與服務的運送國家/地區相符。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。
locations[]

object (LocationIdSet)

必要欄位。列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。

重量

以字串和單位表示的權重。

JSON 表示法 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
欄位
unit

enum (WeightUnit)

必要欄位。體重單位。可接受的值為 kg 和 lb
amountMicros

string (int64 format)

必要欄位。以微量表示的數字 (1 百萬個微量等於 1 貨幣標準單位，例如 1 公斤 = 1000000 微量)。您也可以將這個欄位設為 -1，設為無限大。這個欄位僅支援 -1 和正值。

WeightUnit

體重單位。

列舉
WEIGHT_UNIT_UNSPECIFIED 未指定單位
POUND 磅
KILOGRAM kg 單位。

LocationIdSet

列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下，才能設定這些欄位。

JSON 表示法 
{
  "locationIds": [
    string
  ]
}
欄位
locationIds[]

string

必要欄位。非空白的地區 ID 清單。它們必須是相同的位置類型 (例如州)。

資料列

加入儲存格清單。

JSON 表示法 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
欄位
cells[]

object (Value)

必要欄位。構成列的儲存格清單。二維資料表的長度必須與 columnHeaders 相同，單維資料表的長度須為 1。

CarrierRate

mainTable 或 singleValue 可參照的貨運公司費率清單。

JSON 表示法 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
欄位
name

string

必要欄位。貨運公司費率的名稱。每個費率群組的名稱不得重複。
carrier

string

必要欄位。電信業者服務，例如 "UPS" 或 "Fedex"。
carrierService

string

必要欄位。電信業者服務，例如 "ground" 或 "2 days"。
originPostalCode

string

必要欄位。此貨運公司費率的運送起點。
percentageAdjustment

string

選用設定。乘法調節係數，以十進位標記法的形式表示。可以是負數。舉例來說，"5.4" 可將比率提高 5.4%，"-3" 則降低 3%。
flatAdjustment

object (Price)

選用設定。附加運費調節係數。可以是負數。舉例來說，{ "amountMicros": 1, "currencyCode" : "USD" } 會在稅率中加入 $1 美元，{ "amountMicros": -3, "currencyCode" : "USD" } 則從稅率中移除 $3 美元。

ShipmentType

運送服務類型。

列舉
SHIPMENT_TYPE_UNSPECIFIED 這項服務未指定運送類型。
DELIVERY 這項服務會將訂單寄到消費者選擇的地址。
LOCAL_DELIVERY 這項服務會將訂單寄到消費者選擇的地址。訂單商品會由附近的當地門市出貨。
COLLECTION_POINT 這項服務會將訂單寄到消費者選擇的地址。訂單會從取貨地點出貨。

MinimumOrderValueTable

取貨配送類型的個別商店最低訂單值表格。

JSON 表示法 
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
欄位
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼集清單。至少需要兩個集合，且最後一個必須留空，表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。

StoreCodeSetWithMov

共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合，且最後一個必須留空，表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。

JSON 表示法 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
欄位
storeCodes[]

string

選用設定。不重複的商家代碼清單，或空白代表所有商家。
value

object (Price)

指定商店的最低訂單價值。

StoreConfig

產品的運送來源清單。這只適用於本地運送運送類型。

JSON 表示法 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
欄位
storeCodes[]

string

選用設定。提供當地交貨服務的商店代碼清單。如果留空，則 all_stores 必須為 true。
storeServiceType

enum (StoreServiceType)

表示這個商家列出的所有商店或特定商店是否提供本地到貨服務。
cutoffConfig

object (CutoffConfig)

與當地配送相關的設定都會在當天結束。
serviceRadius

object (Distance)

最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。

StoreServiceType

表示商家列出的商店或特定商店是否提供本地到貨服務。

列舉
STORE_SERVICE_TYPE_UNSPECIFIED 未指定商店服務類型。
ALL_STORES 表示這個商家列出的所有商店 (包括目前和未來商店) 是否提供店面運送。
SELECTED_STORES 表示只有storeCodes中列出的商店可使用本地配送服務。

CutoffConfig

與當地配送相關的設定都會在當天結束。

JSON 表示法 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
欄位
localCutoffTime

object (LocalCutoffTime)

當天當地到貨的結束時間。
storeCloseOffsetHours

string (int64 format)

僅限店面交車使用。以商店打烊前的時數表示截止時間。與 localCutoffTime 互斥。
noDeliveryPostCutoff

boolean

商家只要將運送服務設為本地到貨 n 天，即可選擇不顯示本地到貨 1 天以上。舉例來說，如果運送服務定義了當天到貨服務，且超過截止時間，將這個欄位設為 true，系統就會計算結果為 NO_DELIVERY_POST_CUTOFF 的運送服務費率。在相同的範例中，如果將這個欄位設為 false，計算的運送時間就是一天。這種提交方式僅適用於本地運送。

LocalCutoffTime

當天當地到貨的結束時間。

JSON 表示法 
{
  "hour": string,
  "minute": string
}
欄位
hour

string (int64 format)

當地時間外送訂單必須在當天下單。
minute

string (int64 format)

當地配送訂單 (分鐘) 必須於當天下單當天處理。

距離

最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。

JSON 表示法 
{
  "value": string,
  "unit": enum (Unit)
}
欄位
value

string (int64 format)

距離的整數值。
unit

enum (Unit)

單位因國家/地區而異，參數則會調整為包含英里和公里。

Unit

單位因國家/地區而異，參數則會調整為包含英里和公里。

列舉
UNIT_UNSPECIFIED 未指定單位
MILES 單位 (英里)
KILOMETERS 單位 (公里)

LoyaltyProgram

商家提供的會員方案。

JSON 表示法 
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
欄位
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

選用設定。這項運送服務的會員方案等級。
programLabel

string

這是你在 Merchant Center 會員方案設定中設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。

LoyaltyProgramTiers

商家會員方案子集。

JSON 表示法 
{
  "tierLabel": string
}
欄位
tierLabel

string

等級標籤 [tierLabel] 子屬性可用於區分不同會員等級的產品層級福利。此外，Merchant Center 的會員方案設定中也會設定這項屬性值；即使會員方案只有 1 個階層，變更資料來源時，也必須提供這項屬性值。

Warehouse

出貨倉庫，用於儲存及處理庫存。下一個代碼：7

JSON 表示法 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
欄位
name

string

必要欄位。倉庫的名稱。在帳戶內不得重複。
shippingAddress

object (Address)

必要欄位。倉庫的運送地址。
cutoffTime

object (WarehouseCutoffTime)

必要欄位。訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。
handlingDays

string (int64 format)

必要欄位。從這個倉庫出貨及運送商品所需的天數。這是倉庫層級，但可根據商品屬性在商品層級覆寫。
businessDayConfig

object (BusinessDayConfig)

倉庫的工作天。如未設定，預設為星期一至星期五。

地址

倉庫的運送地址。

JSON 表示法 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
欄位
streetAddress

string

地址的街道層級。例如 111w 31st Street。
city

string

必要欄位。城市、鄉鎮或縣市。也可能包含附屬區域或鄉鎮市區 (例如社區或郊區)。
administrativeArea

string

必要欄位。國家/地區的頂層行政劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。
postalCode

string

必要欄位。郵遞區號 (例如「94043」)。
regionCode

string

必要欄位。CLDR 國家/地區代碼 (例如「US」)。

WarehouseCutoffTime

訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。

JSON 表示法 
{
  "hour": integer,
  "minute": integer
}
欄位
hour

integer

必要欄位。倉庫必須在同一天的訂單完成處理所需的截止時間。時數以倉庫時區為準。
minute

integer

必要欄位。倉庫必須在同一天提交訂單所需的處理時間，此為截止時間的分鐘數。分鐘數是以倉庫時區為準。