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 được dùng để tránh sự cố 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 lần tạo ban đầu, hãy gọi phương thức get để lấy thẻ etag và dữ liệu trong chế độ cài đặt thông tin vận chuyển hiện tại trước khi chèn cuộc gọi.

  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 bằng thông tin chế độ cài đặt thông tin vận chuyển mong muốn 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ỉ mục cuối cùng được phép có applicableShippingLabels trống, có nghĩa là "mọi thứ khác". applicableShippingLabels khác không được chồng chéo.

loyaltyPrograms[]

object (LoyaltyProgram)

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

serviceName

string

Bắt buộc. Tên dạng tự do của dịch vụ. 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 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ị đặ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ể thiết lập cùng với maxOrderValueTable.

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 giá trị này cùng vớiminimumOrderValue.

storeConfig

object (StoreConfig)

Danh sách cửa hàng bán sản phẩm của bạn. Giá trị này chỉ hợp lệ cho loại hình vận chuyển 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 đặt giá trị này, bạn không cần đặt 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 trong 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 hạn chót nhận đơn hàng của 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 trong cùng ngày, 1 có nghĩa là ngày vận chuyển 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 trong cùng ngày, 1 có nghĩa là ngày vận chuyển tiếp theo. Phải lớn hơn hoặc bằng minHandlingDays. "minXử lý" và "maxhandlingDays" nên được đặt hoặc không được đặt 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 thông tin này, thì ngày làm việc từ thứ Hai đến thứ Sáu sẽ được giả định.

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 thông tin này, thì ngày làm việc từ thứ Hai đến thứ Sáu sẽ được giả định.

CutoffTime

Định nghĩa hạn chót nhận đơn hàng của 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 hạn chót nhận đơn đặt hàng mà khách hàng phải đặt hàng để được xử lý trong cùng ngày.

timeZone

string

Bắt buộc. Giá trị 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 trong quá trình 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 sẽ 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 sẽ có một giá trị cho phương diện đó. Nếu có hai phương diện, thì 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 đến 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, 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".

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 dịch vụ phải có trong danh sách eddSupportedServices.

warehouse

string

Bắt buộc. Tên nhà 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 phụ do mainTable tham chiếu đến. Bạn chỉ có thể thiết lập nếu đã đặt mainTable.

carrierRates[]

object (CarrierRate)

Không bắt buộc. Danh sách mức phí của hãng vận chuyển có thể tham khảo bằng mainTable hoặc singleValue.

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 mainTablesubtables.

mainTable

object (Table)

Một bảng xác định nhóm giá, khi singleValue không đủ biểu cảm. 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 tập hợp này 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 một ô 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. Giá trị phải là true khi đã đặt và chỉ có thể đặt nếu chưa đặt tất cả các trường khác.

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 đủ biểu cảm.

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ác cột của bảng. Không bắt buộc: nếu bạn không đặt chính sách này, thì bảng 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 đối với giá của đơ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 giá trị amountMicros = -1. Ví dụ: [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] cho các tiêu đề "<= 10kg", "<= 50kg" và "> 50 kg". Tất 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 bao gồm số lượng mục giới hạn trên. 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 chưa đặt tất cả các trường khác.

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 chưa đặt tất cả các trường khác.

locations[]

object (LocationIdSet)

Bắt buộc. Danh sách các nhóm 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ố theo 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ợ -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 chưa đặt tất cả các trường khác.

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 một danh sách ô.

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 thành 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 phí của hãng vận chuyển có thể tham khảo bằng mainTable hoặc singleValue.

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 mức phí của hãng vận chuyển. Phải riêng biệ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 vận chuyển cho mức phí 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à giá trị âm. Ví dụ: "5.4" tăng tỷ lệ thêm 5,4%, "-3" sẽ giảm tỷ lệ này xuống 3%.

flatAdjustment

object (Price)

Không bắt buộc. Hệ số điều chỉnh mức phí vận chuyển bổ sung. Có thể là giá trị â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 không chỉ định loại lô hàng.
DELIVERY Dịch vụ này giao hàng đến địa chỉ do khách hàng chọn.
LOCAL_DELIVERY Dịch vụ này giao 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 bộ 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. Cần có ít nhất hai tập hợp và tập cuối cùng phải để trống, biểu thị "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 trong tất cả các tập hợp. 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 duy nhất hoặc để trống để nhận tất cả.

value

object (Price)

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

StoreConfig

Danh sách cửa hàng bán 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à giá trị 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 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 gian 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ị hạn chót nhận đơn hàng dưới dạng số giờ trước khi đóng cửa hàng. 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 dịch vụ giao hàng cùng ngày và đã qua hạn chót nhận đơn đặt hàng, thì việc đặt trường này thành true sẽ dẫn đến việc trả lại mức phí dịch vụ vận chuyển đã tính là 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 gian 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)

Các đơn đặt hàng giao tại địa phương phải được đặt trước để xử lý trong cùng ngày.

Khoảng cách

Bán kính giao hàng tối đa. Thông tin này chỉ bắt buộc đối với 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, đơn vị được tham số để bao gồm dặm và km.

Đơn vị

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

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 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 được 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 tập hợp con 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 muố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 bậc.

Nhà kho

Kho hàng thực hiện đơn hàng, nơi lưu trữ và xử lý hàng tồn kho. Thẻ tiếp theo: 7

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 hàng. 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 ZIP (Ví dụ: "94043").

regionCode

string

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

WarehouseCutoffTime

Thời gian muộn nhất trong ngày mà đơn đặt hàng có thể được chấp nhận và bắt đầu xử lý. 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 hạn chót nhận đơn đặt hàng mà kho hàng phải đặt hàng để xử lý 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 hạn chót nhận đơn đặt hàng mà kho hàng phải đặt 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.