- JSON 表示法
- 服務
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- 星期幾
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- 表格
- 標題
- 重量
- WeightUnit
- LocationIdSet
- 列
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- 距離
- 單位
- LoyaltyProgram
- LoyaltyProgramTiers
- 倉儲
- 地址
- WarehouseCutoffTime
商家帳戶的 [運送設定](https://support.google.com/merchants/answer/6069284)。
JSON 表示法 |
---|
{ "name": string, "services": [ { object ( |
欄位 | |
---|---|
name |
ID。運送設定的資源名稱。格式: |
services[] |
選用設定。目標帳戶的服務清單。 |
warehouses[] |
選用設定。可在 |
etag |
必要欄位。這個欄位可用於避免發生非同步問題。確認來電設定資料在接到來電與插入來電之間不會改變。使用者必須執行下列步驟:
|
服務
運送服務。
JSON 表示法 |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
欄位 | |
---|---|
deliveryCountries[] |
必要欄位。服務適用國家/地區的 CLDR 地域代碼。 |
rateGroups[] |
選用設定。運送費率群組定義。只有最後一個項目可以含有空白的 |
loyaltyPrograms[] |
選用設定。這項運送服務僅適用於特定會員方案。 |
serviceName |
必要欄位。服務名稱 (形式不拘),在目標帳戶中不得重複。 |
active |
必要欄位。顯示運送服務有效狀態的布林值。 |
currencyCode |
這項服務所適用貨幣的 CLDR 代碼。費率群組中的價格必須一致。 |
deliveryTime |
必要欄位。從訂購到產品出貨等各個面向所花費的時間。 |
shipmentType |
這項服務能運送訂單的目標地點類型。 |
minimumOrderValue |
這項服務的最低訂單價值。指定時,表示客戶必須至少支付這個金額。一項服務中的所有價格都必須採用相同幣別。無法與 minOrderValueTable 一起設定。 |
minimumOrderValueTable |
取貨配送類型的個別商店最低訂單值表格。無法與 minOrderValue 一起設定。 |
storeConfig |
產品的運送來源清單。這只適用於本地運送運送類型。 |
DeliveryTime
從訂購到產品出貨等各個面向所花費的時間。
JSON 表示法 |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
欄位 | |
---|---|
warehouseBasedDeliveryTimes[] |
選用設定。表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後,[運送時間][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 中不應設定其他運送時間相關欄位。 |
minTransitDays |
運送過程中的最短工作天數。0 表示當天到貨服務,1 代表次日到貨。必須設定 |
maxTransitDays |
運送過程中花費的最長工作天數。0 表示當天到貨服務,1 代表次日到貨。必須大於或等於 |
cutoffTime |
「工作天」截止時間定義。如未設定,截止時間會預設為太平洋標準時間上午 8 點。 |
minHandlingDays |
訂單出貨前經過的最短工作天數。0 表示出貨當天,1 代表隔天出貨。 |
maxHandlingDays |
訂單出貨前所花費的最長工作天數。0 表示出貨當天,1 代表隔天出貨。必須大於或等於 |
transitTimeTable |
運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。 |
handlingBusinessDayConfig |
訂單處理期間 (工作天)。如未提供,系統會預設採用星期一至星期五的工作天。 |
transitBusinessDayConfig |
訂單可出貨的工作天。如未提供,系統會預設採用星期一至星期五的工作天。 |
CutoffTime
「工作天」截止時間定義。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
欄位 | |
---|---|
hour |
必要欄位。訂單必須在同一天完成處理的截止時間 (小時)。 |
minute |
必要欄位。訂單必須在同一天完成處理的截止時間 (分鐘)。 |
timeZone |
必要欄位。時區 ID,例如「歐洲/蘇黎世」。 |
TransitTable
運送時間表格、運送過程所需的天數 (以列和欄的維度為依據)。minTransitDays
、maxTransitDays
或 transitTimeTable
都可以設定,但不能同時設定兩者。
JSON 表示法 |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
欄位 | |
---|---|
postalCodeGroupNames[] |
必要欄位。區域名稱清單 |
transitTimeLabels[] |
必要欄位。運送時間標籤清單。最後一個值可以是 |
rows[] |
必要欄位。如果只有一組維度組合 |
TransitTimeRow
如果只有一組維度組合 postalCodeGroupNames
或 transitTimeLabels
,則會有多個資料列,每個資料列都具有一個該維度的值。如果有兩個維度,則每列都會對應到 postalCodeGroupNames
,而欄 (值) 則對應到 transitTimeLabels
。
JSON 表示法 |
---|
{
"values": [
{
object ( |
欄位 | |
---|---|
values[] |
必要欄位。運送時間範圍 (最短至最長工作天)。 |
TransitTimeValue
運送時間範圍 (最短至最長工作天)。
JSON 表示法 |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
欄位 | |
---|---|
minTransitDays |
最短運送時間範圍 (以工作天為單位)。0 表示當天到貨服務,1 代表次日到貨。 |
maxTransitDays |
必須大於或等於 |
BusinessDayConfig
倉庫的工作天。
JSON 表示法 |
---|
{
"businessDays": [
enum ( |
欄位 | |
---|---|
businessDays[] |
必要欄位。一般工作天。不得留空。 |
平日
列舉 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
表示應根據所選貨運公司的設定計算各個倉庫的運送時間。設定後,deliveryTime
中不應設定其他運送時間相關欄位。
JSON 表示法 |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
欄位 | |
---|---|
carrier |
必要欄位。電信業者,例如 |
carrierService |
必要欄位。電信業者服務,例如 |
warehouse |
必要欄位。倉儲名稱。這應符合 [warehouse][ShippingSetting.warehouses.name] |
RateGroup
運送費率群組定義。只有最後一個項目可以含有空白的 applicableShippingLabels
,表示「其他」。其他applicableShippingLabels
不得重疊。
JSON 表示法 |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
欄位 | |
---|---|
applicableShippingLabels[] |
必要欄位。運送標籤清單,用於定義這個費率群組適用的產品。這是假造:只有其中一個標籤必須相符,系統才能套用費率群組。只有服務的最後一個費率群組可以留空。 |
subtables[] |
選用設定。 |
carrierRates[] |
選用設定。 |
singleValue |
費率群組的值 (例如固定費率 $10 美元)。只有在未設定 |
mainTable |
當 |
name |
選用設定。費率群組名稱。此設定在運送服務中不得重複。 |
值
費率群組的單一值,或是費率群組表格儲存格的值。必須明確設定 noShipping
、flatRate
、pricePercentage
、carrier_rateName
、subtable_name
其中之一。
JSON 表示法 |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
欄位 | |
---|---|
noShipping |
如果值為 true,產品將無法出貨。設定時必須設為 true,且只有在其他欄位皆未設定的情況下才能設定。 |
flatRate |
固定費率。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
pricePercentage |
以十進位標記法表示的價格百分比,例如 |
carrierRate |
參照相同費率群組中定義的貨運公司費率的貨運公司費率名稱。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
subtable |
子表格的名稱。只能在表格儲存格中設定 (例如不得為單一值),且只有在未設定所有其他欄位的情況下才能設定。 |
資料表
當 singleValue
不夠明確時,定義費率群組的資料表。
JSON 表示法 |
---|
{ "rows": [ { object ( |
欄位 | |
---|---|
rows[] |
必要欄位。構成資料表的資料列清單。長度必須與 |
name |
資料表名稱。子資料表必填,主表格會忽略。 |
rowHeaders |
必要欄位。資料表中資料列的標題。 |
columnHeaders |
資料表中的資料欄標頭。選用:如未設定,表格就只會顯示一個維度。 |
標頭
表格的資料列或欄標題清單不得為空白。必須明確設定 prices
、weights
、num_items
、postalCodeGroupNames
或 location
其中之一。
JSON 表示法 |
---|
{ "prices": [ { object ( |
欄位 | |
---|---|
prices[] |
必要欄位。包含訂單價格上限的清單。最終價格的值可以是無限大,方法是將 price amountMicros 設為 -1。舉例來說, |
weights[] |
必要欄位。包含訂單權重上限的清單。最後一個重量的值可以是無限量,只要設定 price amountMicros = -1 即可。舉例來說, |
numberOfItems[] |
必要欄位。包含項目數量上限的清單。最後一個值可以是 |
postalCodeGroupNames[] |
必要欄位。郵政群組名稱清單。最後一個值可以是 |
locations[] |
必要欄位。列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下,才能設定這些欄位。 |
重量
以字串和單位表示的權重。
JSON 表示法 |
---|
{
"unit": enum ( |
欄位 | |
---|---|
unit |
必要欄位。體重單位。可接受的值為 kg 和 lb |
amountMicros |
必要欄位。以微量表示的數字 (1 百萬個微量等於 1 貨幣標準單位,例如 1 公斤 = 1000000 微量)。您也可以將這個欄位設為 -1,設為無限大。這個欄位僅支援 -1 和正值。 |
WeightUnit
體重單位。
列舉 | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
未指定單位 |
POUND |
磅 |
KILOGRAM |
kg 單位。 |
LocationIdSet
列出地區 ID 組合的清單。不得空白。只有在未設定所有其他欄位的情況下,才能設定這些欄位。
JSON 表示法 |
---|
{ "locationIds": [ string ] } |
欄位 | |
---|---|
locationIds[] |
必要欄位。非空白的地區 ID 清單。它們必須是相同的位置類型 (例如州)。 |
列
加入儲存格清單。
JSON 表示法 |
---|
{
"cells": [
{
object ( |
欄位 | |
---|---|
cells[] |
必要欄位。構成列的儲存格清單。二維資料表的長度必須與 |
CarrierRate
mainTable
或 singleValue
可參照的貨運公司費率清單。
JSON 表示法 |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
欄位 | |
---|---|
name |
必要欄位。貨運公司費率的名稱。每個費率群組的名稱不得重複。 |
carrier |
必要欄位。電信業者服務,例如 |
carrierService |
必要欄位。電信業者服務,例如 |
originPostalCode |
必要欄位。此貨運公司費率的運送起點。 |
percentageAdjustment |
選用設定。乘法調節係數,以十進位標記法的形式表示。可以是負數。舉例來說, |
flatAdjustment |
選用設定。附加運費調節係數。可以是負數。舉例來說, |
ShipmentType
運送服務類型。
列舉 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
這項服務未指定運送類型。 |
DELIVERY |
這項服務會將訂單寄到消費者選擇的地址。 |
LOCAL_DELIVERY |
這項服務會將訂單寄到消費者選擇的地址。訂單商品會由附近的當地門市出貨。 |
COLLECTION_POINT |
這項服務會將訂單寄到消費者選擇的地址。訂單會從取貨地點出貨。 |
MinimumOrderValueTable
取貨配送類型的個別商店最低訂單值表格。
JSON 表示法 |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
欄位 | |
---|---|
storeCodeSetWithMovs[] |
必要欄位。共用相同最低訂單價值 (MOV) 的商店代碼集清單。至少需要兩個集合,且最後一個必須留空,表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。 |
StoreCodeSetWithMov
共用相同最低訂單價值的商店代碼組合清單。至少需要兩個集合,且最後一個必須留空,表示「MOV for 所有其他商店」。每個商家代碼在所有組合中只能出現一次。一項服務中的所有價格都必須採用相同幣別。
JSON 表示法 |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
欄位 | |
---|---|
storeCodes[] |
選用設定。不重複的商家代碼清單,或空白代表所有商家。 |
value |
指定商店的最低訂單價值。 |
StoreConfig
產品的運送來源清單。這只適用於本地運送運送類型。
JSON 表示法 |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
欄位 | |
---|---|
storeCodes[] |
選用設定。提供當地交貨服務的商店代碼清單。如果留空,則 |
storeServiceType |
表示這個商家列出的所有商店或特定商店是否提供本地到貨服務。 |
cutoffConfig |
與當地配送相關的設定都會在當天結束。 |
serviceRadius |
最大運送範圍半徑。只有本地運送包裹類型才需要這項資訊。 |
StoreServiceType
表示商家列出的商店或特定商店是否提供本地到貨服務。
列舉 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
未指定商店服務類型。 |
ALL_STORES |
表示這個商家列出的所有商店 (包括目前和未來商店) 是否提供店面運送。 |
SELECTED_STORES |
表示只有storeCodes 中列出的商店可使用本地配送服務。 |
CutoffConfig
與當地配送相關的設定都會在當天結束。
JSON 表示法 |
---|
{
"localCutoffTime": {
object ( |
欄位 | |
---|---|
localCutoffTime |
當天當地到貨的結束時間。 |
storeCloseOffsetHours |
僅限店面交車使用。以商店打烊前的時數表示截止時間。與 |
noDeliveryPostCutoff |
商家只要將運送服務設為本地到貨 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 ( |
欄位 | |
---|---|
loyaltyProgramTiers[] |
選用設定。這項運送服務的會員方案等級。 |
programLabel |
這是你在 Merchant Center 會員方案設定中設定的會員方案標籤。Google 會根據這項子屬性將你的會員方案對應至符合資格的商品。 |
LoyaltyProgramTiers
商家會員方案子集。
JSON 表示法 |
---|
{ "tierLabel": string } |
欄位 | |
---|---|
tierLabel |
等級標籤 [tierLabel] 子屬性可用於區分不同會員等級的產品層級福利。此外,Merchant Center 的會員方案設定中也會設定這項屬性值;即使會員方案只有 1 個階層,變更資料來源時,也必須提供這項屬性值。 |
Warehouse
出貨倉庫,用於儲存及處理庫存。下一個代碼:7
JSON 表示法 |
---|
{ "name": string, "shippingAddress": { object ( |
欄位 | |
---|---|
name |
必要欄位。倉庫的名稱。在帳戶內不得重複。 |
shippingAddress |
必要欄位。倉庫的運送地址。 |
cutoffTime |
必要欄位。訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。 |
handlingDays |
必要欄位。從這個倉庫出貨及運送商品所需的天數。這是倉庫層級,但可根據商品屬性在商品層級覆寫。 |
businessDayConfig |
倉庫的工作天。如未設定,預設為星期一至星期五。 |
地址
倉庫的運送地址。
JSON 表示法 |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
欄位 | |
---|---|
streetAddress |
地址的街道層級。例如 |
city |
必要欄位。城市、鄉鎮或縣市。也可能包含附屬區域或鄉鎮市區 (例如社區或郊區)。 |
administrativeArea |
必要欄位。國家/地區的頂層行政劃分。例如加州 (「CA」) 或魁北克省 (「QC」)。 |
postalCode |
必要欄位。郵遞區號 (例如「94043」)。 |
regionCode |
必要欄位。CLDR 國家/地區代碼 (例如「US」)。 |
WarehouseCutoffTime
訂單會在一天當中的最晚方便接受並開始處理訂單。系統會在隔天處理後續訂單。時間以倉庫的郵遞區號為準。
JSON 表示法 |
---|
{ "hour": integer, "minute": integer } |
欄位 | |
---|---|
hour |
必要欄位。倉庫必須在同一天的訂單完成處理所需的截止時間。時數以倉庫時區為準。 |
minute |
必要欄位。倉庫必須在同一天提交訂單所需的處理時間,此為截止時間的分鐘數。分鐘數是以倉庫時區為準。 |