- Resource: ShippingSettings
- Layanan
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Weekday
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Tabel
- Header
- Berat
- WeightUnit
- LocationIdSet
- Baris
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distance
- Unit
- LoyaltyProgram
- LoyaltyProgramTiers
- Gudang
- Alamat
- WarehouseCutoffTime
- Metode
Resource: ShippingSettings
Setelan pengiriman akun penjual.
Representasi JSON |
---|
{ "name": string, "services": [ { object ( |
Kolom | |
---|---|
name |
ID. Nama resource setelan pengiriman. Format: |
services[] |
Opsional. Daftar layanan akun target. |
warehouses[] |
Opsional. Daftar gudang yang dapat dirujuk di |
etag |
Wajib. Kolom ini digunakan untuk menghindari masalah asinkron. Pastikan data setelan pengiriman tidak berubah antara panggilan get dan panggilan insert. Pengguna harus melakukan langkah-langkah berikut:
|
Layanan
Layanan pengiriman.
Representasi JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Kolom | |
---|---|
delivery |
Wajib. Kode wilayah CLDR negara tempat layanan berlaku. |
rate |
Opsional. Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan untuk memiliki |
loyalty |
Opsional. Program loyalitas yang dibatasi untuk layanan pengiriman ini. |
service |
Wajib. Nama layanan dalam bentuk bebas. Harus unik dalam akun target. |
active |
Wajib. Boolean yang mengekspos status aktif layanan pengiriman. |
currency |
Kode CLDR mata uang yang berlaku untuk layanan ini. Harus sama dengan harga di grup tarif. |
delivery |
Wajib. Waktu yang dihabiskan dalam berbagai aspek mulai dari pemesanan hingga pengiriman produk. |
shipment |
Jenis lokasi tujuan pengiriman pesanan oleh layanan ini. |
minimum |
Nilai pesanan minimum untuk layanan ini. Jika ditetapkan, menunjukkan bahwa pelanggan harus membelanjakan setidaknya jumlah ini. Semua harga dalam layanan harus memiliki mata uang yang sama. Tidak dapat ditetapkan bersama dengan minimumOrderValueTable. |
minimum |
Tabel nilai pesanan minimum per toko untuk jenis fulfillment pengambilan. Tidak dapat ditetapkan bersama dengan minimumOrderValue. |
store |
Daftar toko tempat produk Anda dikirim. Hal ini hanya berlaku untuk jenis pengiriman pesanan lokal. |
DeliveryTime
Waktu yang dihabiskan dalam berbagai aspek mulai dari pemesanan hingga pengiriman produk.
Representasi JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Kolom | |
---|---|
warehouse |
Opsional. Menunjukkan bahwa waktu pengiriman harus dihitung per gudang (lokasi asal pengiriman) berdasarkan setelan ekspedisi yang dipilih. Jika ditetapkan, tidak ada kolom terkait waktu transit lainnya di [waktu pengiriman][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] yang boleh ditetapkan. |
min |
Jumlah minimum hari kerja yang dihabiskan dalam pengiriman. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya. |
max |
Jumlah maksimum hari kerja yang dihabiskan dalam pengiriman. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya. Harus lebih besar dari atau sama dengan |
cutoff |
Definisi waktu batas hari kerja. Jika tidak dikonfigurasi, waktu batas akan ditetapkan secara default ke 08.00 PST. |
min |
Jumlah minimum hari kerja yang dihabiskan sebelum pesanan dikirim. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. 'minHandlingDays' dan 'maxHandlingDays' harus ditetapkan atau tidak ditetapkan secara bersamaan. |
max |
Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirim. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. Harus lebih besar dari atau sama dengan |
transit |
Tabel waktu transit, jumlah hari kerja yang dihabiskan dalam transit berdasarkan dimensi baris dan kolom. |
handling |
Hari kerja saat pesanan dapat ditangani. Jika tidak disediakan, hari kerja Senin hingga Jumat akan diasumsikan. |
transit |
Hari kerja saat pesanan dapat dalam perjalanan. Jika tidak disediakan, hari kerja Senin hingga Jumat akan diasumsikan. |
CutoffTime
Definisi waktu batas hari kerja.
Representasi JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Kolom | |
---|---|
hour |
Wajib. Jam batas waktu hingga pesanan harus dilakukan agar diproses pada hari yang sama. |
minute |
Wajib. Menit batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama. |
time |
Wajib. ID zona waktu Misalnya "Eropa/Zurich". |
TransitTable
Tabel waktu transit, jumlah hari kerja yang dihabiskan dalam transit berdasarkan dimensi baris dan kolom. minTransitDays
, maxTransitDays
, atau transitTimeTable
dapat ditetapkan, tetapi tidak keduanya.
Representasi JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Kolom | |
---|---|
postal |
Wajib. Daftar nama region |
transit |
Wajib. Daftar label waktu transit. Nilai terakhir dapat berupa |
rows[] |
Wajib. Jika hanya ada satu kumpulan dimensi |
TransitTimeRow
Jika hanya ada satu kumpulan dimensi postalCodeGroupNames
atau transitTimeLabels
, ada beberapa baris yang masing-masing memiliki satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postalCodeGroupNames
, dan kolom (nilai) sesuai dengan transitTimeLabels
.
Representasi JSON |
---|
{
"values": [
{
object ( |
Kolom | |
---|---|
values[] |
Wajib. Rentang waktu transit (min-maks) dalam hari kerja. |
TransitTimeValue
Rentang waktu transit (min-maks) dalam hari kerja.
Representasi JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Kolom | |
---|---|
min |
Rentang waktu transit minimum dalam hari kerja. 0 berarti pengiriman pada hari yang sama, 1 berarti pengiriman pada hari berikutnya. |
max |
Harus lebih besar dari atau sama dengan |
BusinessDayConfig
Hari kerja gudang.
Representasi JSON |
---|
{
"businessDays": [
enum ( |
Kolom | |
---|---|
business |
Wajib. Hari kerja reguler. Tidak boleh kosong. |
Hari kerja
Enum | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
Menunjukkan bahwa waktu pengiriman harus dihitung per gudang (lokasi asal pengiriman) berdasarkan setelan ekspedisi yang dipilih. Jika ditetapkan, tidak ada kolom terkait waktu transit lainnya di deliveryTime
yang boleh ditetapkan.
Representasi JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Kolom | |
---|---|
carrier |
Wajib. Operator, seperti |
carrier |
Wajib. Layanan operator, seperti |
warehouse |
Wajib. Nama gudang. Ini harus cocok dengan [warehouse][ShippingSetting.warehouses.name] |
RateGroup
Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan untuk memiliki applicableShippingLabels
kosong, yang berarti "semua yang lain". applicableShippingLabels
lainnya tidak boleh tumpang-tindih.
Representasi JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Kolom | |
---|---|
applicable |
Wajib. Daftar label paket yang menentukan produk yang menjadi sasaran penerapan grup tarif ini. Ini adalah disjungsi: hanya salah satu label yang harus cocok agar grup tarif dapat diterapkan. Hanya boleh kosong untuk grup tarif terakhir dari suatu layanan. |
subtables[] |
Opsional. Daftar subtabel yang dirujuk oleh |
carrier |
Opsional. Daftar tarif operator yang dapat dirujuk oleh |
single |
Nilai grup tarif (Misalnya tarif tetap $10). Hanya dapat ditetapkan jika |
main |
Tabel yang menentukan grup tarif, jika |
name |
Opsional. Nama grup tarif. Jika ditetapkan, harus unik dalam layanan pengiriman. |
Nilai
Satu nilai grup tarif atau nilai sel tabel grup tarif. Salah satu dari noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
harus ditetapkan.
Representasi JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Kolom | |
---|---|
no |
Jika benar, produk tidak dapat dikirim. Harus benar saat ditetapkan, hanya dapat ditetapkan jika semua kolom lain tidak ditetapkan. |
flat |
Tarif tetap. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan. |
price |
Persentase harga yang direpresentasikan sebagai angka dalam notasi desimal (Misalnya, |
carrier |
Nama tarif ekspedisi yang merujuk pada tarif ekspedisi yang ditentukan dalam grup tarif yang sama. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan. |
subtable |
Nama subtabel. Hanya dapat ditetapkan di sel tabel (Misalnya, bukan untuk nilai tunggal), dan hanya jika semua kolom lainnya tidak ditetapkan. |
Tabel
Tabel yang menentukan grup tarif, jika singleValue
tidak cukup ekspresif.
Representasi JSON |
---|
{ "rows": [ { object ( |
Kolom | |
---|---|
rows[] |
Wajib. Daftar baris yang membentuk tabel. Harus sama panjang dengan |
name |
Nama tabel. Diperlukan untuk subtabel, diabaikan untuk tabel utama. |
row |
Wajib. Header baris tabel. |
column |
Header kolom tabel. Opsional: jika tidak ditetapkan, tabel hanya memiliki satu dimensi. |
Header
Daftar header baris atau kolom yang tidak kosong untuk tabel. Salah satu dari prices
, weights
, num_items
, postalCodeGroupNames
, atau location
harus ditetapkan.
Representasi JSON |
---|
{ "prices": [ { object ( |
Kolom | |
---|---|
prices[] |
Wajib. Daftar batas atas harga pesanan inklusif. Nilai harga terakhir dapat berupa tak terhingga dengan menetapkan price amountMicros = -1. Misalnya, |
weights[] |
Wajib. Daftar batas atas bobot pesanan inklusif. Nilai bobot terakhir dapat berupa tak terbatas dengan menetapkan price amountMicros = -1. Misalnya, |
number |
Wajib. Daftar jumlah batas atas item inklusif. Nilai terakhir dapat berupa |
postal |
Wajib. Daftar nama grup pos. Nilai terakhir dapat berupa |
locations[] |
Wajib. Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan. |
Berat
Bobot yang direpresentasikan sebagai nilai dalam string dan unit.
Representasi JSON |
---|
{
"unit": enum ( |
Kolom | |
---|---|
unit |
Wajib. Unit berat. Nilai yang dapat diterima adalah: kg dan lb |
amount |
Wajib. Berat yang direpresentasikan sebagai angka dalam mikro (1 juta mikro setara dengan satu unit standar mata uang, misalnya, 1 kg = 1.000.000 mikro). Kolom ini juga dapat ditetapkan sebagai tak terbatas dengan menetapkan ke -1. Kolom ini hanya mendukung nilai -1 dan positif. |
WeightUnit
Unit berat.
Enum | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unit tidak ditentukan |
POUND |
Unit lb. |
KILOGRAM |
Unit kg. |
LocationIdSet
Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lainnya tidak ditetapkan.
Representasi JSON |
---|
{ "locationIds": [ string ] } |
Kolom | |
---|---|
location |
Wajib. Daftar ID lokasi yang tidak kosong. Semuanya harus memiliki jenis lokasi yang sama (Misalnya, negara bagian). |
Baris
Sertakan daftar sel.
Representasi JSON |
---|
{
"cells": [
{
object ( |
Kolom | |
---|---|
cells[] |
Wajib. Daftar sel yang membentuk baris. Harus memiliki panjang yang sama dengan |
CarrierRate
Daftar tarif operator yang dapat dirujuk oleh mainTable
atau singleValue
. Layanan operator yang didukung ditentukan di 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.
Representasi JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Kolom | |
---|---|
name |
Wajib. Nama tarif operator. Harus unik per grup tarif. |
carrier |
Wajib. Layanan operator, seperti |
carrier |
Wajib. Layanan operator, seperti |
origin |
Wajib. Asal pengiriman untuk tarif ekspedisi ini. |
percentage |
Opsional. Pengubah tarif pengiriman multiplikatif sebagai angka dalam notasi desimal. Dapat berupa negatif. Misalnya, |
flat |
Opsional. Pengubah tarif pengiriman tambahan. Dapat berupa negatif. Misalnya, |
ShipmentType
Jenis pengiriman layanan pengiriman.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Layanan ini tidak menentukan jenis pengiriman. |
DELIVERY |
Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan. |
LOCAL_DELIVERY |
Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan. Pesanan dikirim dari toko lokal di sekitar. |
COLLECTION_POINT |
Layanan ini mengirimkan pesanan ke alamat yang dipilih oleh pelanggan. Pesanan dikirim dari lokasi pengambilan. |
MinimumOrderValueTable
Tabel nilai pesanan minimum per toko untuk jenis fulfillment pengambilan.
Representasi JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Kolom | |
---|---|
store |
Wajib. Daftar kumpulan kode toko yang memiliki nilai pesanan minimum (MOV) yang sama. Setidaknya diperlukan dua set dan set terakhir harus kosong, yang menandakan 'MOV untuk semua toko lainnya'. Setiap kode toko hanya dapat muncul satu kali di semua set. Semua harga dalam layanan harus memiliki mata uang yang sama. |
StoreCodeSetWithMov
Daftar kumpulan kode toko yang memiliki nilai pesanan minimum yang sama. Setidaknya diperlukan dua set dan set terakhir harus kosong, yang menandakan 'MOV untuk semua toko lainnya'. Setiap kode toko hanya dapat muncul satu kali di semua set. Semua harga dalam layanan harus memiliki mata uang yang sama.
Representasi JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
Kolom | |
---|---|
store |
Opsional. Daftar kode toko unik atau kosong untuk kode generik. |
value |
Nilai pesanan minimum untuk toko tertentu. |
StoreConfig
Daftar toko tempat produk Anda dikirim. Hal ini hanya berlaku untuk jenis pengiriman pesanan lokal.
Representasi JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Kolom | |
---|---|
store |
Opsional. Daftar kode toko yang menyediakan pengiriman lokal. Jika kosong, |
store |
Menunjukkan apakah semua toko, atau toko tertentu, yang tercantum oleh penjual ini menyediakan pengiriman lokal. |
cutoff |
Konfigurasi yang terkait dengan pengiriman lokal berakhir untuk hari itu. |
service |
Radius pengiriman maksimum. Hal ini hanya diperlukan untuk jenis pengiriman pengiriman lokal. |
StoreServiceType
Menunjukkan apakah semua toko, atau toko tertentu, yang tercantum oleh penjual menyediakan pengiriman lokal.
Enum | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
Tidak menentukan jenis layanan toko. |
ALL_STORES |
Menunjukkan apakah semua toko, saat ini dan mendatang, yang tercantum oleh penjual ini menyediakan pengiriman lokal. |
SELECTED_STORES |
Menunjukkan bahwa hanya toko yang tercantum di storeCodes yang memenuhi syarat untuk pengiriman lokal. |
CutoffConfig
Konfigurasi yang terkait dengan pengiriman lokal berakhir untuk hari itu.
Representasi JSON |
---|
{
"localCutoffTime": {
object ( |
Kolom | |
---|---|
local |
Waktu pengiriman lokal berakhir untuk hari tersebut. |
store |
Hanya berlaku dengan fulfillment pengiriman lokal. Merepresentasikan waktu batas sebagai jumlah jam sebelum toko tutup. Tidak dapat muncul bersamaan dengan |
no |
Penjual dapat memilih untuk tidak menampilkan pengiriman lokal n+1 hari jika mereka memiliki layanan pengiriman yang dikonfigurasi ke pengiriman lokal n hari. Misalnya, jika layanan pengiriman menentukan pengiriman pada hari yang sama, dan sudah melewati batas waktu, menetapkan kolom ini ke |
LocalCutoffTime
Waktu pengiriman lokal berakhir untuk hari tersebut.
Representasi JSON |
---|
{ "hour": string, "minute": string } |
Kolom | |
---|---|
hour |
Pesanan pengiriman lokal harus dilakukan sebelum jam untuk diproses pada hari yang sama. |
minute |
Pesanan pengiriman lokal menit harus dilakukan sebelum batas waktu untuk diproses pada hari yang sama. |
Jarak
Radius pengiriman maksimum. Hal ini hanya diperlukan untuk jenis pengiriman pengiriman lokal.
Representasi JSON |
---|
{
"value": string,
"unit": enum ( |
Kolom | |
---|---|
value |
Nilai bilangan bulat jarak. |
unit |
Satuan dapat berbeda berdasarkan negara, dan diparameterkan untuk menyertakan mil dan kilometer. |
Unit
Satuan dapat berbeda berdasarkan negara, dan diparameterkan untuk menyertakan mil dan kilometer.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unit tidak ditentukan |
MILES |
Satuan dalam mil |
KILOMETERS |
Satuan dalam kilometer |
LoyaltyProgram
Program loyalitas yang disediakan oleh penjual.
Representasi JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Kolom | |
---|---|
loyalty |
Opsional. Tingkat program loyalitas layanan pengiriman ini. |
program |
Ini adalah label program loyalitas yang ditetapkan di setelan program loyalitas Anda di Merchant Center. Sub-atribut ini memungkinkan Google memetakan program loyalitas Anda ke penawaran yang memenuhi syarat. |
LoyaltyProgramTiers
Subkumpulan program loyalitas penjual.
Representasi JSON |
---|
{ "tierLabel": string } |
Kolom | |
---|---|
tier |
Sub-atribut label tingkat [tierLabel] membedakan manfaat level penawaran di antara setiap tingkat. Nilai ini juga ditetapkan di setelan program Anda di Merchant Center, dan diperlukan untuk perubahan sumber data meskipun program loyalitas Anda hanya memiliki 1 tingkat. |
Gudang
Gudang fulfillment, yang menyimpan dan menangani inventaris.
Representasi JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Kolom | |
---|---|
name |
Wajib. Nama gudang. Harus unik dalam akun. |
shipping |
Wajib. Alamat pengiriman gudang. |
cutoff |
Wajib. Waktu terakhir pesanan dapat diterima dan mulai diproses. Pesanan yang dilakukan nanti akan diproses pada hari berikutnya. Waktu ini didasarkan pada kode pos gudang. |
handling |
Wajib. Jumlah hari yang diperlukan gudang ini untuk mengemas dan mengirimkan item. Hal ini dilakukan di tingkat gudang, tetapi dapat diganti di tingkat penawaran berdasarkan atribut item. |
business |
Hari kerja gudang. Jika tidak ditetapkan, hari kerja defaultnya adalah Senin hingga Jumat. |
Alamat
Alamat pengiriman gudang.
Representasi JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Kolom | |
---|---|
street |
Bagian alamat di tingkat jalan. Misalnya: |
city |
Wajib. Kota, kota kecil, atau komune. Dapat juga mencakup lokalitas atau sublokalitas dependen (Misalnya lingkungan atau pinggiran kota). |
administrative |
Wajib. Subdivisi administratif tingkat atas negara. Misalnya, negara bagian seperti California ("CA") atau provinsi seperti Quebec ("QC"). |
postal |
Wajib. Kode pos atau ZIP (Misalnya "94043"). |
region |
Wajib. Kode negara CLDR (Misalnya "US"). |
WarehouseCutoffTime
Waktu terakhir pesanan dapat diterima dan mulai diproses. Pesanan yang dilakukan nanti akan diproses pada hari berikutnya. Waktu ini didasarkan pada kode pos gudang.
Representasi JSON |
---|
{ "hour": integer, "minute": integer } |
Kolom | |
---|---|
hour |
Wajib. Jam batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama oleh gudang. Jam didasarkan pada zona waktu gudang. |
minute |
Wajib. Menit batas waktu hingga pesanan harus dilakukan agar dapat diproses pada hari yang sama oleh gudang. Menit didasarkan pada zona waktu gudang. |
Metode |
|
---|---|
|
Mengambil informasi setelan pengiriman. |
|
Ganti setelan pengiriman penjual dengan setelan pengiriman permintaan. |