REST Resource: accounts.shippingSettings

แหล่งข้อมูล: ShippingSettings

การตั้งค่าการจัดส่งของบัญชีผู้ขาย

การแสดง JSON 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
ช่อง
name

string

ตัวระบุ ชื่อแหล่งข้อมูลของการตั้งค่าการจัดส่ง รูปแบบ: accounts/{account}/shippingSetting
services[]

object (Service)

ไม่บังคับ รายการบริการของบัญชีเป้าหมาย
warehouses[]

object (Warehouse)

ไม่บังคับ รายการคลังสินค้าที่ใช้อ้างอิงใน services ได้
etag

string

ต้องระบุ ช่องนี้ใช้เพื่อหลีกเลี่ยงปัญหาการทำงานแบบไม่พร้อมกัน ตรวจสอบว่าข้อมูลการตั้งค่าการจัดส่งไม่มีการเปลี่ยนแปลงระหว่างการเรียกใช้การเรียกและแทรกการเรียก ผู้ใช้ควรทําตามขั้นตอนต่อไปนี้

  1. ตั้งค่าช่อง etag เป็นสตริงว่างสำหรับการสร้างการตั้งค่าการจัดส่งเริ่มต้น

  2. หลังจากสร้างครั้งแรก ให้เรียกใช้เมธอด get เพื่อรับ etag และข้อมูลการตั้งค่าการจัดส่งปัจจุบันก่อนเรียกใช้เมธอด insert

  3. แก้ไขข้อมูลการตั้งค่าการจัดส่งที่ต้องการ

  4. เรียกใช้เมธอดแทรกพร้อมข้อมูลการตั้งค่าการจัดส่งที่ต้องการพร้อม etag ที่ได้มาจากขั้นตอนที่ 2

  5. หากข้อมูลการตั้งค่าการจัดส่งมีการเปลี่ยนแปลงระหว่างขั้นตอนที่ 2 กับขั้นตอนที่ 4 คำขอแทรกจะดำเนินการไม่สำเร็จเนื่องจาก etag จะเปลี่ยนแปลงทุกครั้งที่มีการเปลี่ยนแปลงข้อมูลการตั้งค่าการจัดส่ง ผู้ใช้ควรทำซ้ำขั้นตอนที่ 2-4 ด้วย etag ใหม่

บริการ

บริการจัดส่ง

การแสดง 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)

มูลค่าการสั่งซื้อขั้นต่ำสำหรับบริการนี้ หากตั้งค่าไว้ จะเป็นตัวบ่งชี้ว่าลูกค้าจะต้องใช้จ่ายอย่างน้อยเท่านี้ ราคาทั้งหมดในบริการหนึ่งๆ ใช้สกุลเงินเดียวกัน ตั้งค่าร่วมกับ minimumOrderValueTable ไม่ได้
minimumOrderValueTable

object (MinimumOrderValueTable)

ตารางมูลค่าการสั่งซื้อขั้นต่ำต่อร้านค้าสำหรับประเภทการดำเนินการตามคำสั่งซื้อแบบรับสินค้าที่ร้าน ตั้งค่าร่วมกับ minimumOrderValue ไม่ได้
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)

ไม่บังคับ บ่งบอกว่าควรคำนวณเวลานำส่งตามคลังสินค้า (ต้นทางการจัดส่ง) โดยอิงตามการตั้งค่าของผู้ให้บริการขนส่งที่เลือก เมื่อตั้งค่าแล้ว ไม่ควรตั้งค่าช่องอื่นๆ ที่เกี่ยวข้องกับเวลาขนส่งใน [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]
minTransitDays

integer

จำนวนวันทำการขั้นต่ำที่ใช้ขนส่ง 0 หมายถึงการนำส่งวันเดียวกัน ส่วน 1 หมายถึงการนำส่งในวันถัดไป ต้องตั้งค่า minTransitDays, maxTransitDays หรือ transitTimeTable อย่างใดอย่างหนึ่งเท่านั้น
maxTransitDays

integer

จำนวนวันทำการสูงสุดที่ใช้ขนส่ง 0 หมายถึงการนำส่งวันเดียวกัน ส่วน 1 หมายถึงการนำส่งในวันถัดไป ต้องมากกว่าหรือเท่ากับ minTransitDays
cutoffTime

object (CutoffTime)

คำจำกัดความของเวลาปิดรับวันทำการ หากไม่ได้กําหนดค่า ระบบจะตั้งค่าเวลาปิดรับคำสั่งซื้อเริ่มต้นเป็น 08:00 น. (PST)
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

ต้องระบุ ตัวระบุเขตเวลา เช่น "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 เพียงชุดเดียว จะมีหลายแถวที่มีค่า 1 ค่าสําหรับมิติข้อมูลนั้น หากมีมิติข้อมูล 2 รายการ แต่ละแถวจะสอดคล้องกับ postalCodeGroupNames และแต่ละคอลัมน์ (ค่า) จะสอดคล้องกับ transitTimeLabels

TransitTimeRow

หากมีชุดมิติข้อมูล postalCodeGroupNames หรือ transitTimeLabels เพียงชุดเดียว จะมีหลายแถวที่มีค่า 1 ค่าสําหรับมิติข้อมูลนั้น หากมีมิติข้อมูล 2 รายการ แต่ละแถวจะสอดคล้องกับ 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)

ต้องระบุ วันทำการปกติ ต้องระบุ

ตั๋ววันธรรมดา

Enum
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

หากเป็น "จริง" แสดงว่าผลิตภัณฑ์จัดส่งไม่ได้ ต้องตั้งค่าเป็น "จริง" เมื่อตั้งค่า และตั้งค่าได้ก็ต่อเมื่อไม่ได้ตั้งค่าช่องอื่นๆ ทั้งหมด
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 เพียง 1 รายการ

การแสดง 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"}] แสดงส่วนหัว "<= 10 กก.", "<= 50 กก." และ "> 50 กก." น้ำหนักทั้งหมดภายในบริการต้องมีหน่วยเดียวกัน ต้องระบุข้อมูล ต้องเป็นค่าบวก ยกเว้น -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)

ต้องระบุ รายการชุดรหัสสถานที่ตั้ง ต้องระบุข้อมูล ตั้งค่าได้ก็ต่อเมื่อไม่ได้ตั้งค่าช่องอื่นๆ ทั้งหมด

น้ำหนัก

น้ำหนักที่แสดงเป็นค่าในสตริงและหน่วย

การแสดง JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
ช่อง
unit

enum (WeightUnit)

ต้องระบุ หน่วยน้ำหนัก ค่าที่ยอมรับได้คือ kg และ lb
amountMicros

string (int64 format)

ต้องระบุ น้ำหนักที่แสดงเป็นตัวเลขเป็นไมโคร (1 ล้านไมโครมีค่าเท่ากับหน่วยมาตรฐานของสกุลเงิน เช่น 1 กก. = 1000000 ไมโคร) นอกจากนี้ คุณยังตั้งค่าฟิลด์นี้เป็น "ไม่จำกัด" ได้โดยตั้งค่าเป็น -1 ช่องนี้รองรับเฉพาะค่า -1 และค่าบวก

WeightUnit

หน่วยน้ำหนัก

Enum
WEIGHT_UNIT_UNSPECIFIED ไม่ได้ระบุหน่วย
POUND หน่วย lb
KILOGRAM หน่วย kg

LocationIdSet

รายการชุดรหัสสถานที่ตั้ง ต้องระบุข้อมูล ตั้งค่าได้ก็ต่อเมื่อไม่ได้ตั้งค่าช่องอื่นๆ ทั้งหมด

การแสดง JSON 
{
  "locationIds": [
    string
  ]
}
ช่อง
locationIds[]

string

ต้องระบุ รายการรหัสสถานที่ตั้งที่ไม่ใช่ค่าว่าง โดยต้องทั้งหมดเป็นสถานที่ตั้งประเภทเดียวกัน (เช่น รัฐ)

แถว

ใส่รายการเซลล์

การแสดง JSON 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
ช่อง
cells[]

object (Value)

ต้องระบุ รายการเซลล์ที่ประกอบกันเป็นแถว ต้องมีความยาวเท่ากับ columnHeaders สำหรับตาราง 2 มิติ และความยาว 1 สำหรับตาราง 1 มิติ

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

ประเภทการจัดส่งของบริการจัดส่ง

Enum
SHIPMENT_TYPE_UNSPECIFIED บริการนี้ไม่ได้ระบุประเภทการจัดส่ง
DELIVERY บริการนี้จะจัดส่งคำสั่งซื้อไปยังที่อยู่ซึ่งลูกค้าเลือก
LOCAL_DELIVERY บริการนี้จะจัดส่งคำสั่งซื้อไปยังที่อยู่ซึ่งลูกค้าเลือก คำสั่งซื้อดังกล่าวจะจัดส่งจากร้านค้าในพื้นที่ใกล้เคียง
COLLECTION_POINT บริการนี้จะจัดส่งคำสั่งซื้อไปยังที่อยู่ซึ่งลูกค้าเลือก คำสั่งซื้อดังกล่าวจัดส่งจากจุดรับสินค้า

MinimumOrderValueTable

ตารางมูลค่าการสั่งซื้อขั้นต่ำต่อร้านค้าสำหรับประเภทการดำเนินการตามคำสั่งซื้อแบบรับสินค้าที่ร้าน

การแสดง JSON 
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
ช่อง
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

ต้องระบุ รายการชุดรหัสร้านค้าที่มีมูลค่าการสั่งซื้อขั้นต่ำ (MOV) เดียวกัน ต้องมีอย่างน้อย 2 ชุด และชุดสุดท้ายต้องว่างเปล่า ซึ่งหมายถึง "MOV สำหรับร้านค้าอื่นๆ ทั้งหมด" รหัสร้านค้าแต่ละรหัสจะปรากฏได้เพียงครั้งเดียวในชุดทั้งหมด ราคาทั้งหมดในบริการหนึ่งๆ ใช้สกุลเงินเดียวกัน

StoreCodeSetWithMov

รายการชุดรหัสร้านค้าที่มีมูลค่าการสั่งซื้อขั้นต่ำเดียวกัน ต้องมีอย่างน้อย 2 ชุด และชุดสุดท้ายต้องว่างเปล่า ซึ่งหมายถึง "MOV สำหรับร้านค้าอื่นๆ ทั้งหมด" รหัสร้านค้าแต่ละรหัสจะปรากฏได้เพียงครั้งเดียวในชุดทั้งหมด ราคาทั้งหมดในบริการหนึ่งๆ ใช้สกุลเงินเดียวกัน

การแสดง 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 ต้องเป็น "จริง"
storeServiceType

enum (StoreServiceType)

ระบุว่าร้านค้าทั้งหมดหรือร้านค้าที่เลือกซึ่งแสดงโดยผู้ขายรายนี้ให้บริการนำส่งในพื้นที่หรือไม่
cutoffConfig

object (CutoffConfig)

การกําหนดค่าที่เกี่ยวข้องกับการนำส่งในพื้นที่จะสิ้นสุดลงสำหรับวันนั้น
serviceRadius

object (Distance)

รัศมีสูงสุดสำหรับการนำส่ง ข้อมูลนี้จำเป็นสำหรับประเภทการจัดส่งแบบนำส่งในพื้นที่เท่านั้น

StoreServiceType

ระบุว่าร้านค้าทั้งหมดหรือร้านค้าที่เลือกซึ่งผู้ขายแสดงไว้มีการนำส่งในพื้นที่หรือไม่

Enum
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 วันได้เมื่อกำหนดค่าบริการจัดส่งเป็นการนำส่งในพื้นที่ภายใน n วัน ตัวอย่างเช่น หากบริการจัดส่งกำหนดการนำส่งวันเดียวกันและคำสั่งซื้ออยู่นอกเหนือเวลาปิดรับคำสั่งซื้อ การตั้งค่าช่องนี้เป็น true จะทำให้อัตราบริการจัดส่งที่คำนวณได้แสดงเป็น NO_DELIVERY_POST_CUTOFF ในตัวอย่างนี้ การตั้งค่าช่องนี้เป็น false จะทำให้ระบบคำนวณเวลาจัดส่งเป็น 1 วัน การดำเนินการนี้มีไว้สำหรับการนำส่งในพื้นที่เท่านั้น

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)

หน่วยอาจแตกต่างกันไปตามประเทศ โดยมีการกําหนดค่าให้รวมไมล์และกิโลเมตร

หน่วย

หน่วยอาจแตกต่างกันไปตามประเทศ โดยมีการกําหนดค่าให้รวมไมล์และกิโลเมตร

Enum
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 ระดับ

คลังสินค้า

คลังสินค้าสำหรับดำเนินการตามคำสั่งซื้อ ซึ่งจัดเก็บและจัดการสินค้าคงคลัง

การแสดง 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

ต้องระบุ นาทีของเวลาปิดรับคำสั่งซื้อที่ลูกค้าต้องสั่งซื้อเพื่อให้คลังสินค้าประมวลผลคำสั่งซื้อในวันเดียวกัน นาทีจะอิงตามเขตเวลาของคลังสินค้า

เมธอด

getShippingSettings

 เรียกข้อมูลการตั้งค่าการจัดส่ง

insert

 แทนที่การตั้งค่าการจัดส่งของผู้ขายด้วยการตั้งค่าการจัดส่งตามคำขอ