REST Resource: accounts.shippingSettings

Tài nguyên: ShippingSettings

Chế độ cài đặt thông tin vận chuyển của tài khoản người bán.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của chế độ cài đặt thông tin vận chuyển. Định dạng accounts/{account}/shippingSetting
services[]

object (Service)

Không bắt buộc. Danh sách dịch vụ của tài khoản mục tiêu.
warehouses[]

object (Warehouse)

Không bắt buộc. Danh sách kho hàng có thể được tham chiếu trong services.
etag

string

Bắt buộc. Trường này dùng để tránh vấn đề không đồng bộ. Đảm bảo dữ liệu chế độ cài đặt thông tin vận chuyển không thay đổi giữa lệnh gọi get và lệnh gọi insert. Người dùng nên làm theo các bước sau:

  1. Đặt trường etag thành chuỗi trống để tạo chế độ cài đặt thông tin vận chuyển ban đầu.

  2. Sau khi tạo lần đầu, hãy gọi phương thức get để lấy etag và dữ liệu chế độ cài đặt thông tin vận chuyển hiện tại trước khi gọi phương thức chèn.

  3. Sửa đổi thành thông tin cài đặt phí vận chuyển mà bạn muốn.

  4. Gọi phương thức chèn với thông tin chế độ cài đặt thông tin vận chuyển mong muốn cùng với etag thu được từ bước 2.

  5. Nếu dữ liệu chế độ cài đặt thông tin vận chuyển đã thay đổi giữa bước 2 và bước 4. Yêu cầu chèn sẽ không thành công vì etag thay đổi mỗi khi dữ liệu chế độ cài đặt thông tin vận chuyển thay đổi. Người dùng nên lặp lại bước 2-4 với etag mới.

Dịch vụ

Dịch vụ vận chuyển.

Biểu diễn dưới dạng 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)
  }
}
Trường
deliveryCountries[]

string

Bắt buộc. Mã lãnh thổ CLDR của các quốc gia áp dụng dịch vụ.
rateGroups[]

object (RateGroup)

Không bắt buộc. Định nghĩa nhóm mức phí vận chuyển. Chỉ phần tử cuối cùng được phép có applicableShippingLabels trống, nghĩa là "mọi phần tử khác". applicableShippingLabels khác không được chồng chéo.
loyaltyPrograms[]

object (LoyaltyProgram)

Không bắt buộc. Các chương trình khách hàng thân thiết mà dịch vụ vận chuyển này chỉ áp dụng.
serviceName

string

Bắt buộc. Tên dịch vụ ở dạng tuỳ ý. Phải là duy nhất trong tài khoản mục tiêu.
active

boolean

Bắt buộc. Một boolean cho thấy trạng thái đang hoạt động của dịch vụ vận chuyển.
currencyCode

string

Mã CLDR của đơn vị tiền tệ áp dụng cho dịch vụ này. Phải khớp với giá trong các nhóm giá.
deliveryTime

object (DeliveryTime)

Bắt buộc. Thời gian dành cho nhiều khía cạnh từ khi đặt hàng đến khi giao sản phẩm.
shipmentType

enum (ShipmentType)

Loại địa điểm mà dịch vụ này vận chuyển đơn đặt hàng đến.
minimumOrderValue

object (Price)

Giá trị đơn đặt hàng tối thiểu cho dịch vụ này. Nếu được đặt, thuộc tính này cho biết khách hàng sẽ phải chi tiêu ít nhất số tiền này. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ. Không thể đặt cùng với minimumOrderValueTable.
minimumOrderValueTable

object (MinimumOrderValueTable)

Bảng giá trị đơn đặt hàng tối thiểu theo cửa hàng cho loại phương thức thực hiện là đến lấy hàng. Không thể đặt cùng với minimumOrderValue.
storeConfig

object (StoreConfig)

Danh sách các cửa hàng phân phối sản phẩm của bạn. Trường này chỉ hợp lệ cho loại lô hàng giao hàng tại địa phương.

DeliveryTime

Thời gian dành cho nhiều khía cạnh từ khi đặt hàng đến khi giao sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
Trường
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

Không bắt buộc. Cho biết thời gian giao hàng phải được tính theo từng kho (vị trí gửi hàng) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi bạn đặt thuộc tính này, bạn không được đặt bất kỳ trường nào khác liên quan đến thời gian vận chuyển trong [thời gian giao hàng][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]].
minTransitDays

integer

Số ngày làm việc tối thiểu để vận chuyển. 0 có nghĩa là giao hàng cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo. Bạn phải đặt minTransitDays, maxTransitDays hoặc transitTimeTable, nhưng không được đặt cả hai.
maxTransitDays

integer

Số ngày làm việc tối đa để vận chuyển. 0 có nghĩa là giao hàng cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo. Phải lớn hơn hoặc bằng minTransitDays.
cutoffTime

object (CutoffTime)

Định nghĩa về thời điểm cắt giảm trong ngày làm việc. Nếu bạn không định cấu hình, thì thời gian cắt sẽ được đặt mặc định là 8:00 sáng theo Giờ chuẩn Thái Bình Dương.
minHandlingDays

integer

Số ngày làm việc tối thiểu trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển cùng ngày, 1 có nghĩa là vận chuyển vào ngày tiếp theo. Bạn phải đặt hoặc không đặt "minHandlingDays" và "maxHandlingDays" cùng một lúc.
maxHandlingDays

integer

Số ngày làm việc tối đa trước khi đơn đặt hàng được vận chuyển. 0 có nghĩa là vận chuyển cùng ngày, 1 có nghĩa là vận chuyển vào ngày tiếp theo. Phải lớn hơn hoặc bằng minHandlingDays. Bạn phải đặt hoặc không đặt "minHandlingDays" và "maxHandlingDays" cùng một lúc.
transitTimeTable

object (TransitTable)

Bảng thời gian vận chuyển, số ngày làm việc để vận chuyển dựa trên phương diện hàng và cột. Bạn có thể đặt minTransitDays, maxTransitDays hoặc transitTimeTable, nhưng không được đặt cả hai.
handlingBusinessDayConfig

object (BusinessDayConfig)

Những ngày làm việc mà đơn đặt hàng có thể được xử lý. Nếu bạn không cung cấp, hệ thống sẽ giả định là các ngày làm việc từ thứ Hai đến thứ Sáu.
transitBusinessDayConfig

object (BusinessDayConfig)

Những ngày làm việc mà đơn đặt hàng có thể đang được vận chuyển. Nếu bạn không cung cấp, hệ thống sẽ giả định là các ngày làm việc từ thứ Hai đến thứ Sáu.

CutoffTime

Định nghĩa về thời điểm cắt giảm trong ngày làm việc.

Biểu diễn dưới dạng JSON 
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
Trường
hour

integer

Bắt buộc. Giờ của thời hạn đặt hàng mà khách hàng phải đặt hàng để đơn đặt hàng được xử lý trong cùng ngày.
minute

integer

Bắt buộc. Phút của thời hạn đặt hàng mà khách hàng phải đặt đơn hàng để đơn hàng được xử lý trong cùng ngày.
timeZone

string

Bắt buộc. Mã nhận dạng múi giờ Ví dụ: "Châu Âu/Zurich".

TransitTable

Bảng thời gian vận chuyển, số ngày làm việc để vận chuyển dựa trên phương diện hàng và cột. Bạn có thể đặt minTransitDays, maxTransitDays hoặc transitTimeTable, nhưng không được đặt cả hai.

Biểu diễn dưới dạng JSON 
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
Trường
postalCodeGroupNames[]

string

Bắt buộc. Danh sách tên khu vực Region.name . Giá trị cuối cùng có thể là "all other locations". Ví dụ: ["zone 1", "zone 2", "all other locations"]. Các nhóm mã bưu chính được tham chiếu phải khớp với quốc gia giao hàng của dịch vụ.
transitTimeLabels[]

string

Bắt buộc. Danh sách nhãn thời gian vận chuyển. Giá trị cuối cùng có thể là "all other labels". Ví dụ: ["food", "electronics", "all other labels"].
rows[]

object (TransitTimeRow)

Bắt buộc. Nếu chỉ có một nhóm phương diện postalCodeGroupNames hoặc transitTimeLabels, thì sẽ có nhiều hàng, mỗi hàng có một giá trị cho phương diện đó. Nếu có hai phương diện, mỗi hàng tương ứng với một postalCodeGroupNames và các cột (giá trị) tương ứng với một transitTimeLabels.

TransitTimeRow

Nếu chỉ có một nhóm phương diện postalCodeGroupNames hoặc transitTimeLabels, thì sẽ có nhiều hàng, mỗi hàng có một giá trị cho phương diện đó. Nếu có hai phương diện, mỗi hàng tương ứng với một postalCodeGroupNames và các cột (giá trị) tương ứng với một transitTimeLabels.

Biểu diễn dưới dạng JSON 
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
Trường
values[]

object (TransitTimeValue)

Bắt buộc. Phạm vi thời gian vận chuyển (tối thiểu-tối đa) tính theo ngày làm việc.

TransitTimeValue

Phạm vi thời gian vận chuyển (tối thiểu-tối đa) tính theo ngày làm việc.

Biểu diễn dưới dạng JSON 
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
Trường
minTransitDays

integer

Phạm vi thời gian vận chuyển tối thiểu tính theo ngày làm việc. 0 có nghĩa là giao hàng cùng ngày, 1 có nghĩa là giao hàng vào ngày tiếp theo.
maxTransitDays

integer

Phải lớn hơn hoặc bằng minTransitDays.

BusinessDayConfig

Ngày làm việc của kho hàng.

Biểu diễn dưới dạng JSON 
{
  "businessDays": [
    enum (Weekday)
  ]
}
Trường
businessDays[]

enum (Weekday)

Bắt buộc. Ngày làm việc thông thường. Không được để trống.

Ngày trong tuần

Enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

Cho biết thời gian giao hàng phải được tính theo từng kho (vị trí gửi hàng) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi đặt trường này, bạn không được đặt trường nào khác liên quan đến thời gian vận chuyển trong deliveryTime.

Biểu diễn dưới dạng JSON 
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
Trường
carrier

string

Bắt buộc. Nhà mạng, chẳng hạn như "UPS" hoặc "Fedex". nhà mạng được hỗ trợ
carrierService

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "ground" hoặc "2 days". Tên của dịch vụ phải có trong danh sách eddSupportedServices.
warehouse

string

Bắt buộc. Tên kho. Giá trị này phải khớp với [warehouse][ShippingSetting.warehouses.name]

RateGroup

Định nghĩa nhóm mức phí vận chuyển. Chỉ phần tử cuối cùng được phép có applicableShippingLabels trống, nghĩa là "mọi phần tử khác". applicableShippingLabels khác không được chồng chéo.

Biểu diễn dưới dạng JSON 
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
Trường
applicableShippingLabels[]

string

Bắt buộc. Danh sách nhãn vận chuyển xác định những sản phẩm áp dụng cho nhóm mức phí này. Đây là một câu lệnh loại trừ: chỉ cần một trong các nhãn khớp thì nhóm mức giá mới áp dụng. Chỉ có thể để trống đối với nhóm mức giá cuối cùng của một dịch vụ.
subtables[]

object (Table)

Không bắt buộc. Danh sách các bảng con được mainTable tham chiếu đến. Chỉ có thể đặt nếu bạn đặt mainTable.
carrierRates[]

object (CarrierRate)

Không bắt buộc. Danh sách mức giá của nhà mạng mà mainTable hoặc singleValue có thể tham chiếu đến.
singleValue

object (Value)

Giá trị của nhóm giá (Ví dụ: giá cố định 10 USD). Chỉ có thể đặt nếu bạn không đặt mainTable và subtables.
mainTable

object (Table)

Một bảng xác định nhóm giá, khi singleValue không đủ rõ ràng. Chỉ có thể đặt nếu bạn không đặt singleValue.
name

string

Không bắt buộc. Tên của nhóm giá. Nếu bộ phải là duy nhất trong dịch vụ vận chuyển.

Giá trị

Giá trị duy nhất của một nhóm giá hoặc giá trị của ô trong bảng nhóm giá. Bạn phải đặt chính xác một trong các giá trị noShipping, flatRate, pricePercentage, carrier_rateName, subtable_name.

Biểu diễn dưới dạng JSON 
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
Trường
noShipping

boolean

Nếu giá trị là đúng, thì sản phẩm không thể được vận chuyển. Phải là true khi được đặt, chỉ có thể đặt nếu tất cả các trường khác không được đặt.
flatRate

object (Price)

Mức phí cố định. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
pricePercentage

string

Tỷ lệ phần trăm của giá được biểu thị dưới dạng số theo ký hiệu thập phân (ví dụ: "5.4"). Bạn chỉ có thể đặt giá trị này nếu không đặt tất cả các trường khác.
carrierRate

string

Tên của mức giá của hãng vận chuyển đề cập đến mức giá của hãng vận chuyển được xác định trong cùng một nhóm giá. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
subtable

string

Tên của bảng phụ. Chỉ có thể đặt trong các ô bảng (ví dụ: không phải cho các giá trị đơn lẻ) và chỉ khi tất cả các trường khác không được đặt.

Bảng

Một bảng xác định nhóm giá, khi singleValue không đủ rõ ràng.

Biểu diễn dưới dạng JSON 
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
Trường
rows[]

object (Row)

Bắt buộc. Danh sách các hàng tạo nên bảng. Phải có cùng độ dài với rowHeaders.
name

string

Tên bảng. Bắt buộc đối với bảng phụ, bị bỏ qua đối với bảng chính.
rowHeaders

object (Headers)

Bắt buộc. Tiêu đề của các hàng trong bảng.
columnHeaders

object (Headers)

Tiêu đề của các cột trong bảng. Không bắt buộc: nếu không được đặt, bảng sẽ chỉ có một phương diện.

Tiêu đề

Danh sách không trống gồm các tiêu đề hàng hoặc cột cho một bảng. Bạn phải đặt chính xác một trong các giá trị prices, weights, num_items, postalCodeGroupNames hoặc location.

Biểu diễn dưới dạng JSON 
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
Trường
prices[]

object (Price)

Bắt buộc. Danh sách các giới hạn trên của giá bao gồm cả thuế cho đơn đặt hàng. Giá trị của giá cuối cùng có thể là vô hạn bằng cách đặt price amountMicros = -1. Ví dụ: [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] đại diện cho các tiêu đề "<= $10", "<= $500" và "> $500". Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ. Không được để trống. Phải là số dương, ngoại trừ -1. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
weights[]

object (Weight)

Bắt buộc. Danh sách các giới hạn trên bao gồm cả trọng số đơn đặt hàng. Giá trị của trọng số cuối cùng có thể là vô cực bằng cách đặt price amountMicros = -1. Ví dụ: [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] đại diện cho các tiêu đề "<= 10kg", "<= 50kg" và "> 50kg". Tất cả các trọng số trong một dịch vụ phải có cùng đơn vị. Không được để trống. Phải là số dương, ngoại trừ -1. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
numberOfItems[]

string

Bắt buộc. Danh sách giới hạn trên bao gồm số lượng mục. Giá trị cuối cùng có thể là "infinity". Ví dụ: ["10", "50", "infinity"] đại diện cho các tiêu đề "<= 10 mục", "<= 50 mục" và "> 50 mục". Không được để trống. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
postalCodeGroupNames[]

string

Bắt buộc. Danh sách tên nhóm bưu chính. Giá trị cuối cùng có thể là "all other locations". Ví dụ: ["zone 1", "zone 2", "all other locations"]. Các nhóm mã bưu chính được tham chiếu phải khớp với quốc gia giao hàng của dịch vụ. Không được để trống. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.
locations[]

object (LocationIdSet)

Bắt buộc. Danh sách các tập hợp mã vị trí. Không được để trống. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.

Trọng lượng

Trọng số được biểu thị dưới dạng giá trị trong chuỗi và đơn vị.

Biểu diễn dưới dạng JSON 
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
Trường
unit

enum (WeightUnit)

Bắt buộc. Đơn vị trọng lượng. Các giá trị được chấp nhận là: kg và lb
amountMicros

string (int64 format)

Bắt buộc. Trọng lượng được biểu thị dưới dạng số trong micro (1 triệu micro tương đương với một đơn vị tiền tệ tiêu chuẩn, ví dụ: 1 kg = 1000000 micro). Bạn cũng có thể đặt trường này thành vô cực bằng cách đặt thành -1. Trường này chỉ hỗ trợ giá trị -1 và giá trị dương.

WeightUnit

Đơn vị trọng lượng.

Enum
WEIGHT_UNIT_UNSPECIFIED đơn vị không được chỉ định
POUND Đơn vị lb.
KILOGRAM Đơn vị kg.

LocationIdSet

Danh sách các tập hợp mã vị trí. Không được để trống. Chỉ có thể đặt nếu tất cả các trường khác đều chưa được đặt.

Biểu diễn dưới dạng JSON 
{
  "locationIds": [
    string
  ]
}
Trường
locationIds[]

string

Bắt buộc. Danh sách mã vị trí không trống. Tất cả đều phải thuộc cùng một loại vị trí (ví dụ: tiểu bang).

Hàng

Bao gồm danh sách các ô.

Biểu diễn dưới dạng JSON 
{
  "cells": [
    {
      object (Value)
    }
  ]
}
Trường
cells[]

object (Value)

Bắt buộc. Danh sách các ô tạo nên hàng. Phải có cùng độ dài với columnHeaders đối với bảng hai chiều, độ dài là 1 đối với bảng một chiều.

CarrierRate

Danh sách mức giá của nhà mạng mà mainTable hoặc singleValue có thể tham chiếu đến. Các dịch vụ của hãng vận chuyển được hỗ trợ được xác định tại 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.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
Trường
name

string

Bắt buộc. Tên của mức giá của hãng vận chuyển. Phải là duy nhất cho mỗi nhóm giá.
carrier

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "UPS" hoặc "Fedex".
carrierService

string

Bắt buộc. Dịch vụ của nhà mạng, chẳng hạn như "ground" hoặc "2 days".
originPostalCode

string

Bắt buộc. Điểm xuất phát của dịch vụ vận chuyển theo mức giá của hãng vận chuyển này.
percentageAdjustment

string

Không bắt buộc. Hệ số mức phí vận chuyển theo hệ số nhân dưới dạng số ở dạng thập phân. Có thể là số âm. Ví dụ: "5.4" tăng tỷ lệ 5,4%, "-3" giảm tỷ lệ 3%.
flatAdjustment

object (Price)

Không bắt buộc. Công cụ sửa đổi mức phí vận chuyển. Có thể là số âm. Ví dụ: { "amountMicros": 1, "currencyCode" : "USD" } thêm 1 đô la vào giá, { "amountMicros": -3, "currencyCode" : "USD" } xoá 3 đô la khỏi giá.

ShipmentType

Loại hình vận chuyển của dịch vụ vận chuyển.

Enum
SHIPMENT_TYPE_UNSPECIFIED Dịch vụ này chưa chỉ định loại lô hàng.
DELIVERY Dịch vụ này vận chuyển đơn đặt hàng đến địa chỉ do khách hàng chọn.
LOCAL_DELIVERY Dịch vụ này vận chuyển đơn đặt hàng đến địa chỉ do khách hàng chọn. Đơn đặt hàng được vận chuyển từ một cửa hàng địa phương ở gần bạn.
COLLECTION_POINT Dịch vụ này vận chuyển đơn đặt hàng đến địa chỉ do khách hàng chọn. Đơn đặt hàng được vận chuyển từ một điểm đến lấy hàng.

MinimumOrderValueTable

Bảng giá trị đơn đặt hàng tối thiểu theo cửa hàng cho loại phương thức thực hiện là đến lấy hàng.

Biểu diễn dưới dạng JSON 
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
Trường
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

Bắt buộc. Danh sách các nhóm mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu (MOV). Bạn phải có ít nhất hai tập hợp và tập hợp cuối cùng phải trống, nghĩa là "MOV cho tất cả các cửa hàng khác". Mỗi mã cửa hàng chỉ có thể xuất hiện một lần trên tất cả các bộ. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ.

StoreCodeSetWithMov

Danh sách các nhóm mã cửa hàng có cùng giá trị đơn đặt hàng tối thiểu. Bạn phải có ít nhất hai tập hợp và tập hợp cuối cùng phải trống, nghĩa là "MOV cho tất cả các cửa hàng khác". Mỗi mã cửa hàng chỉ có thể xuất hiện một lần trên tất cả các bộ. Tất cả giá trong một dịch vụ phải có cùng đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
Trường
storeCodes[]

string

Không bắt buộc. Danh sách các mã cửa hàng riêng biệt hoặc để trống cho mã tổng hợp.
value

object (Price)

Giá trị đơn đặt hàng tối thiểu cho các cửa hàng đã cho.

StoreConfig

Danh sách các cửa hàng phân phối sản phẩm của bạn. Trường này chỉ hợp lệ cho loại lô hàng giao hàng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
Trường
storeCodes[]

string

Không bắt buộc. Danh sách mã cửa hàng cung cấp dịch vụ giao hàng tại địa phương. Nếu trống, thì all_stores phải là true.
storeServiceType

enum (StoreServiceType)

Cho biết liệu tất cả cửa hàng hay một số cửa hàng mà người bán này đăng thông tin có cung cấp dịch vụ giao hàng tại địa phương hay không.
cutoffConfig

object (CutoffConfig)

Các cấu hình liên quan đến dịch vụ giao hàng tại địa phương sẽ kết thúc trong ngày.
serviceRadius

object (Distance)

Bán kính giao hàng tối đa. Bạn chỉ cần cung cấp thông tin này cho loại lô hàng giao hàng tại địa phương.

StoreServiceType

Cho biết liệu tất cả cửa hàng hay một số cửa hàng mà người bán liệt kê có cung cấp dịch vụ giao hàng tại địa phương hay không.

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Chưa chỉ định loại dịch vụ tại cửa hàng.
ALL_STORES Cho biết liệu tất cả cửa hàng (hiện tại và trong tương lai) do người bán này đăng có cung cấp dịch vụ giao hàng tại địa phương hay không.
SELECTED_STORES Cho biết rằng chỉ những cửa hàng được liệt kê trong storeCodes mới đủ điều kiện để giao hàng tại địa phương.

CutoffConfig

Các cấu hình liên quan đến dịch vụ giao hàng tại địa phương sẽ kết thúc trong ngày.

Biểu diễn dưới dạng JSON 
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
Trường
localCutoffTime

object (LocalCutoffTime)

Thời điểm kết thúc dịch vụ giao hàng tại địa phương trong ngày.
storeCloseOffsetHours

string (int64 format)

Chỉ hợp lệ khi phương thức thực hiện đơn hàng là giao hàng tại địa phương. Biểu thị thời gian cắt giảm dưới dạng số giờ trước khi cửa hàng đóng cửa. Loại trừ lẫn nhau với localCutoffTime.
noDeliveryPostCutoff

boolean

Người bán có thể chọn không hiển thị dịch vụ giao hàng tại địa phương trong n+1 ngày khi họ thiết lập dịch vụ vận chuyển là giao hàng tại địa phương trong n ngày. Ví dụ: nếu dịch vụ vận chuyển xác định giao hàng cùng ngày và đã quá hạn chót, thì việc đặt trường này thành true sẽ khiến mức phí dịch vụ vận chuyển được tính toán trả về NO_DELIVERY_POST_CUTOFF. Trong cùng ví dụ này, việc đặt trường này thành false sẽ dẫn đến thời gian vận chuyển được tính là một ngày. Lựa chọn này chỉ dành cho dịch vụ giao hàng tại địa phương.

LocalCutoffTime

Thời điểm kết thúc dịch vụ giao hàng tại địa phương trong ngày.

Biểu diễn dưới dạng JSON 
{
  "hour": string,
  "minute": string
}
Trường
hour

string (int64 format)

Bạn phải đặt đơn hàng giao hàng tại địa phương theo giờ để đơn hàng được xử lý trong cùng ngày.
minute

string (int64 format)

Bạn phải đặt đơn hàng giao hàng tại địa phương trong vòng vài phút để đơn hàng được xử lý trong cùng ngày.

Khoảng cách

Bán kính giao hàng tối đa. Bạn chỉ cần cung cấp thông tin này cho loại lô hàng giao hàng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "value": string,
  "unit": enum (Unit)
}
Trường
value

string (int64 format)

Giá trị số nguyên của khoảng cách.
unit

enum (Unit)

Đơn vị có thể khác nhau tuỳ theo quốc gia, được tham số hoá để bao gồm dặm và kilômét.

Đơn vị

Đơn vị có thể khác nhau tuỳ theo quốc gia, được tham số hoá để bao gồm dặm và kilômét.

Enum
UNIT_UNSPECIFIED Đơn vị không xác định
MILES Đơn vị tính là dặm
KILOMETERS Đơn vị tính bằng kilômét

LoyaltyProgram

Chương trình khách hàng thân thiết do người bán cung cấp.

Biểu diễn dưới dạng JSON 
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
Trường
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

Không bắt buộc. Bậc trong chương trình khách hàng thân thiết của dịch vụ vận chuyển này.
programLabel

string

Đây là nhãn chương trình khách hàng thân thiết mà bạn thiết lập trong chế độ cài đặt chương trình khách hàng thân thiết trong Merchant Center. Thuộc tính phụ này giúp Google liên kết chương trình khách hàng thân thiết của bạn với các mặt hàng đủ điều kiện.

LoyaltyProgramTiers

Một phần của chương trình khách hàng thân thiết của người bán.

Biểu diễn dưới dạng JSON 
{
  "tierLabel": string
}
Trường
tierLabel

string

Thuộc tính phụ nhãn phân cấp [tierLabel] phân biệt lợi ích theo cấp mặt hàng giữa từng cấp. Giá trị này cũng được đặt trong chế độ cài đặt chương trình trong Merchant Center. Đây là giá trị bắt buộc nếu bạn thay đổi nguồn dữ liệu ngay cả khi chương trình khách hàng thân thiết của bạn chỉ có 1 cấp.

Nhà kho

Kho thực hiện đơn hàng, nơi lưu trữ và xử lý khoảng không quảng cáo.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
Trường
name

string

Bắt buộc. Tên kho. Phải là duy nhất trong tài khoản.
shippingAddress

object (Address)

Bắt buộc. Địa chỉ giao hàng của kho.
cutoffTime

object (WarehouseCutoffTime)

Bắt buộc. Thời điểm muộn nhất trong ngày mà bạn có thể chấp nhận và bắt đầu xử lý đơn đặt hàng. Các đơn đặt hàng sau đó sẽ được xử lý vào ngày tiếp theo. Thời gian này dựa trên mã bưu chính của kho.
handlingDays

string (int64 format)

Bắt buộc. Số ngày cần thiết để kho này đóng gói và vận chuyển một mặt hàng. Giá này ở cấp kho, nhưng có thể được ghi đè ở cấp mặt hàng dựa trên các thuộc tính của một mặt hàng.
businessDayConfig

object (BusinessDayConfig)

Ngày làm việc của kho hàng. Nếu bạn không đặt, thì theo mặc định, ngày bắt đầu sẽ là thứ Hai đến thứ Sáu.

Địa chỉ

Địa chỉ giao hàng của kho.

Biểu diễn dưới dạng JSON 
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
Trường
streetAddress

string

Phần địa chỉ ở cấp đường phố. Ví dụ: 111w 31st Street.
city

string

Bắt buộc. Thành phố, thị trấn hoặc xã. Có thể bao gồm cả các địa phương phụ thuộc hoặc địa phương phụ (ví dụ: khu dân cư hoặc vùng ngoại ô).
administrativeArea

string

Bắt buộc. Phân khu hành chính cấp cao nhất của quốc gia. Ví dụ: một tiểu bang như California ("CA") hoặc một tỉnh như Quebec ("QC").
postalCode

string

Bắt buộc. Mã bưu chính hoặc mã ZIP (Ví dụ: "94043").
regionCode

string

Bắt buộc. Mã quốc gia CLDR (Ví dụ: "US").

WarehouseCutoffTime

Thời điểm muộn nhất trong ngày mà bạn có thể chấp nhận và bắt đầu xử lý đơn đặt hàng. Các đơn đặt hàng sau đó sẽ được xử lý vào ngày tiếp theo. Thời gian này dựa trên mã bưu chính của kho.

Biểu diễn dưới dạng JSON 
{
  "hour": integer,
  "minute": integer
}
Trường
hour

integer

Bắt buộc. Giờ của thời hạn đặt hàng mà khách hàng phải đặt hàng để kho xử lý đơn đặt hàng trong cùng ngày. Giờ dựa trên múi giờ của kho.
minute

integer

Bắt buộc. Phút của thời hạn đặt hàng mà khách hàng phải đặt hàng để kho hàng xử lý đơn đặt hàng trong cùng ngày. Phút được tính theo múi giờ của kho.

Phương thức

getShippingSettings

 Truy xuất thông tin về chế độ cài đặt thông tin vận chuyển.

insert

 Thay thế chế độ cài đặt thông tin vận chuyển của người bán bằng chế độ cài đặt yêu cầu vận chuyển.