ShippingSettings

商家帳戶的運送設定。

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 代表次日出貨。minHandlingDays和「maxHandlingDays」可以同時設定或不同時設定。
maxHandlingDays

integer

訂單出貨前所需的工作天數上限。0 表示出貨當天，1 代表隔天出貨。必須大於或等於 minHandlingDays。請同時設定或不設定「minHandlingDays」和「maxHandlingDays」。
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，例如「Europe/Zurich」。

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」和「">」NT$1,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 all other stores」。每個商家代碼在所有組合中只能出現一次。服務中的所有價格都必須使用相同的貨幣。

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_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

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