ShippingSettings

[chế độ cài đặt thông tin vận chuyển]((https://support.google.com/merchants/answer/6069284) 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 đích.

warehouses[]

object (Warehouse)

Không bắt buộc. Danh sách các nhà kho có thể 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 rằng dữ liệu trong chế độ cài đặt thông tin vận chuyển không thay đổi giữa thời điểm nhận cuộc gọi và chèn cuộc gọi. Người dùng nên làm theo các bước sau:

  1. Đặt trường thẻ etag làm 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 mong muốn về chế độ cài đặt thông tin vận chuyển.

  4. Phương pháp chèn cuộc gọi có thông tin về chế độ cài đặt thông tin vận chuyển mong muốn bằng etag có được ở 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ì thẻ etag thay đổi mỗi khi dữ liệu trong 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 thẻ 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 về 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 đích.

active

boolean

Bắt buộc. Giá trị boolean cho biết trạng thái 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á của các mức giá trong các nhóm giá.

deliveryTime

object (DeliveryTime)

Bắt buộc. Thời gian bỏ ra cho các khía cạnh khác nhau từ lúc đặ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, hãy cho biết rằng 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ớiMinimumOrderValueTable.

minimumOrderValueTable

object (MinimumOrderValueTable)

Bảng giá trị đơn đặt hàng tối thiểu mỗi cửa hàng đối với cách thực hiện đơn hàng để đế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ệ đối với loại hình vận chuyển giao hàng tại địa phương.

DeliveryTime

Thời gian bỏ ra cho các khía cạnh khác nhau từ lúc đặ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 hàng (vị trí nguồn gốc vận chuyển) dựa trên chế độ cài đặt của hãng vận chuyển đã chọn. Khi đặt chính sách 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 [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 được dành cho quá trình 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. 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 thiết lập, hạn chót nhận đơn hàng sẽ được đặt mặc định là 8 giờ sáng theo giờ PST.

minHandlingDays

integer

Số ngày làm việc tối thiểu phải bỏ ra 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.

maxHandlingDays

integer

Số ngày làm việc tối đa đã bỏ ra 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.

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 kích thước hàng và cột. Bạn có thể đặt minTransitDays, maxTransitDays hoặc transitTimeTable, nhưng không thể đặ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)

Ngày làm việc mà đơn đặt hàng có thể đượ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ờ hạn chót nhận đơn hàng mà khách hàng phải đặt để 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 đã vận chuyển dựa trên kích thước hàng và cột. Bạn có thể đặt minTransitDays, maxTransitDays hoặc transitTimeTable, nhưng không thể đặ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 giới thiệ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, 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 đến 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 trong 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 hàng (vị trí nguồn gốc vận chuyển) 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. Thuộc tính này phải khớp với [warehouse][Shippingsetting.warehouses.name]

RateGroup

Định nghĩa về 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.

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 được áp dụng nhóm giá này. Đây là sự phân tách: chỉ một trong các nhãn phải khớp thì nhóm giá mới được áp dụng. Chỉ được để trống đối với nhóm 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). Chỉ có thể thiết lập nếu bạn chưa đặt mainTablesubtables.

mainTable

object (Table)

Một bảng xác định nhóm giá, khi singleValue không đủ biểu cảm. Bạn chỉ có thể thiết lập nếu chưa đặt singleValue.

name

string

Không bắt buộc. Tên của nhóm giá. Nếu tập hợp 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á. 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 đúng thì sản phẩm sẽ không thể được vận chuyển. Giá trị này 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 chưa đặt tất cả các trường khác.

pricePercentage

string

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

carrierRate

string

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

subtable

string

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

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 thành bảng. Phải có cùng độ dài như 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) bao gồm các tiêu đề của hàng hoặc cột của 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á đơn đặt hàng được bao gồm. Giá trị của giá gần đây nhất có thể là vô hạn bằng cách đặt giá trị micros = -1. Ví dụ: [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] 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 chưa đặt tất cả các trường khác.

weights[]

object (Weight)

Bắt buộc. Danh sách các giới hạn trên đối với 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à "> 50kg". 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 chưa đặt tất cả các trường khác.

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"] 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 giới thiệ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 chưa đặt tất cả các trường khác.

Cân nặng

Trọng số được biểu thị dưới dạng giá trị 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 diễn dưới dạng số bằng micrô (1 triệu micros tương đương với đơn vị tiêu chuẩn tiền tệ của một người, ví dụ: 1 kg = 1000000 micros). Trường này cũng có thể được đặt 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 nhóm 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. Một danh sách mã vị trí không trống. Tất cả các vị trí này 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ó độ dài bằng 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 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 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. Cấp số nhân của đối tượng sửa đổi mức phí vận chuyển dưới dạng một số trong ký hiệu 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" } cộng 1 đô la vào mức giá, { "amountMicros": -3, "currencyCode" : "USD" } sẽ xoá 3 đô la khỏi mức 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 xác định loại hình vận chuyển.
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ủa bạn được vận chuyển từ một cửa hàng địa phương gần đó.
COLLECTION_POINT 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 điểm đến lấy hàng.

MinimumOrderValueTable

Bảng giá trị đơn đặt hàng tối thiểu mỗi cửa hàng đối với cách thực hiện đơn hàng để đế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). 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ệ.

StoreCodeSetWithMov

Danh sách các bộ 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. Giá trị này chỉ hợp lệ đối với loại hình vận chuyển 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 hoặc một số cửa hàng 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.

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 vào ngày đó.

serviceRadius

object (Distance)

Bán kính giao hàng tối đa. Thuộc tính này chỉ bắt buộc đối với loại hình vận chuyển giao hàng tại địa phương.

StoreServiceType

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

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Không chỉ định loại dịch vụ cửa hàng.
ALL_STORES Cho biết liệu tất cả cửa hàng (hiện tại và 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ó trong danh sách 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 vào 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 thực hiện đơn hàng giao 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 vòng 1 ngày khi họ thiết lập dịch vụ vận chuyển thành giao hàng tại địa phương trong vòng 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 ví dụ tương tự, việc thiết lập trường này thành false sẽ dẫn đến thời gian vận chuyển được tính toán là một ngày. Tính năng này chỉ áp dụng 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)

Các đơn giao hàng theo giờ tại địa phương phải được đặt trướ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. Thuộc tính này chỉ bắt buộc đối với loại hình vận chuyển 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 Chưa chỉ định đơn vị
MILES Đơn vị tính bằng 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 hàng.

cutoffTime

object (WarehouseCutoffTime)

Bắt buộc. 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 hàng.

handlingDays

string (int64 format)

Bắt buộc. Số ngày cần thiết để kho hàng này đóng gói và vận chuyển một mặt hàng. Đây là giá trị ở cấp kho hàng nhưng có thể thay thế cho cấp mặt hàng dựa trên các thuộc tính của 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 chính sách này, giá trị này sẽ là thứ Hai đến thứ Sáu theo mặc định.

Địa chỉ

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

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

string

Một phần cấp đường phố của địa chỉ. Ví dụ: 111w 31st Street.

city

string

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

administrativeArea

string

Bắt buộc. Đơn vị 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 hàng.

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ờ được dựa trên múi giờ của kho hàng.

minute

integer

Bắt buộc. Số 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ý trong cùng ngày. Phút dựa trên múi giờ của kho hàng.