- Representasi JSON
- Layanan
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Hari kerja
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Tabel
- Header
- Berat
- WeightUnit
- LocationIdSet
- Baris
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Jarak
- Satuan
- LoyaltyProgram
- LoyaltyProgramTiers
- Pergudangan
- Alamat
- WarehouseCutoffTime
[Setelan pengiriman]((https://support.google.com/merchants/answer/6069284) 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 get call dan insert call. Pengguna harus melakukan langkah-langkah berikut:
|
Layanan
Layanan pengiriman.
Representasi JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Kolom | |
---|---|
deliveryCountries[] |
Wajib. Kode wilayah CLDR negara tempat layanan berlaku. |
rateGroups[] |
Opsional. Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan memiliki |
loyaltyPrograms[] |
Opsional. Program loyalitas yang dibatasi untuk layanan pengiriman ini. |
serviceName |
Wajib. Nama layanan dalam bentuk bebas. Harus unik dalam akun target. |
active |
Wajib. Boolean yang menampilkan status aktif layanan pengiriman. |
currencyCode |
Kode CLDR mata uang yang menggunakan layanan ini. Harus sama dengan harga di kelompok tarif. |
deliveryTime |
Wajib. Waktu yang dihabiskan dalam berbagai aspek, mulai dari pemesanan hingga pengiriman produk. |
shipmentType |
Jenis lokasi tujuan pengiriman pesanan. |
minimumOrderValue |
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. |
minimumOrderValueTable |
Tabel nilai pesanan minimum per toko untuk jenis pemenuhan pesanan pengambilan. Tidak dapat ditetapkan bersama dengan minimumOrderValue. |
storeConfig |
Daftar toko asal pengiriman produk Anda. Ini hanya berlaku untuk jenis pengiriman lokal. |
DeliveryTime
Waktu yang dihabiskan dalam berbagai aspek, mulai dari pemesanan hingga pengiriman produk.
Representasi JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Kolom | |
---|---|
warehouseBasedDeliveryTimes[] |
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 lain di [waktu pengiriman][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] yang harus ditetapkan. |
minTransitDays |
Jumlah hari kerja minimum yang dihabiskan untuk transit. 0 berarti pengiriman di hari yang sama, 1 berarti pengiriman di hari berikutnya. |
maxTransitDays |
Jumlah maksimum hari kerja yang dihabiskan untuk transit. 0 berarti pengiriman di hari yang sama, 1 berarti pengiriman di hari berikutnya. Harus lebih besar dari atau sama dengan |
cutoffTime |
Definisi batas waktu hari kerja. Jika tidak dikonfigurasi, batas waktu akan disetel secara default ke pukul 08.00 PST. |
minHandlingDays |
Jumlah hari kerja minimum yang dihabiskan sebelum pesanan dikirimkan. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. |
maxHandlingDays |
Jumlah maksimum hari kerja yang dihabiskan sebelum pesanan dikirimkan. 0 berarti dikirim pada hari yang sama, 1 berarti dikirim pada hari berikutnya. Harus lebih besar dari atau sama dengan |
transitTimeTable |
Tabel waktu transit, jumlah hari kerja yang dihabiskan untuk transit berdasarkan dimensi baris dan kolom. |
handlingBusinessDayConfig |
Hari kerja saat pesanan dapat ditangani. Jika tidak diberikan, hari kerja akan dianggap sebagai hari kerja Senin hingga Jumat. |
transitBusinessDayConfig |
Hari kerja saat pesanan dapat berada dalam pengiriman. Jika tidak diberikan, hari kerja akan dianggap sebagai hari kerja Senin hingga Jumat. |
CutoffTime
Definisi batas waktu hari kerja.
Representasi JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Kolom | |
---|---|
hour |
Wajib. Jam batas waktu hingga pesanan harus diproses pada hari yang sama. |
minute |
Wajib. Menit batas waktu hingga pesanan harus diproses pada hari yang sama. |
timeZone |
Wajib. ID zona waktu Misalnya "Eropa/Zurich". |
TransitTable
Tabel waktu transit, jumlah hari kerja yang dihabiskan untuk transit berdasarkan dimensi baris dan kolom. minTransitDays
, maxTransitDays
, atau transitTimeTable
dapat ditetapkan, tetapi tidak keduanya.
Representasi JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Kolom | |
---|---|
postalCodeGroupNames[] |
Wajib. Daftar nama wilayah |
transitTimeLabels[] |
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
, masing-masing ada beberapa baris dengan satu nilai untuk dimensi tersebut. Jika ada dua dimensi, setiap baris sesuai dengan postalCodeGroupNames
, dan kolom (nilai) 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 | |
---|---|
minTransitDays |
Rentang waktu transit minimum dalam hari kerja. 0 berarti pengiriman di hari yang sama, 1 berarti pengiriman di hari berikutnya. |
maxTransitDays |
Harus lebih besar dari atau sama dengan |
BusinessDayConfig
Hari kerja gudang.
Representasi JSON |
---|
{
"businessDays": [
enum ( |
Kolom | |
---|---|
businessDays[] |
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 lain di deliveryTime
yang harus ditetapkan.
Representasi JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Kolom | |
---|---|
carrier |
Wajib. Operator, seperti |
carrierService |
Wajib. Layanan ekspedisi, seperti |
warehouse |
Wajib. Nama gudang. Ini harus cocok dengan [warehouse][ShippingSetting.warehouses.name] |
RateGroup
Definisi grup tarif pengiriman. Hanya yang terakhir yang diizinkan memiliki applicableShippingLabels
kosong, yang berarti "lainnya". applicableShippingLabels
lainnya tidak boleh tumpang-tindih.
Representasi JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Kolom | |
---|---|
applicableShippingLabels[] |
Wajib. Daftar label paket yang menentukan untuk produk apa kelompok tarif ini berlaku. Ini adalah disjungsi: hanya satu label yang harus cocok agar grup tarif dapat diterapkan. Mungkin hanya kosong untuk grup tarif terakhir layanan. |
subtables[] |
Opsional. Daftar subtabel yang dirujuk oleh |
carrierRates[] |
Opsional. Daftar tarif ekspedisi yang dapat dirujuk oleh |
singleValue |
Nilai grup tarif (Misalnya tarif tetap $10). Hanya dapat disetel jika |
mainTable |
Tabel yang menentukan grup tarif, saat |
name |
Opsional. Nama grup tarif. Jika ditetapkan harus unik dalam layanan pengiriman. |
Nilai
Nilai tunggal grup tarif atau nilai sel tabel grup tarif. Tepat satu dari noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
harus ditetapkan.
Representasi JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Kolom | |
---|---|
noShipping |
Jika true (benar), produk tidak dapat dikirim. Harus bernilai benar jika ditetapkan, hanya dapat ditetapkan jika semua kolom lain tidak ditetapkan. |
flatRate |
Tarif tetap. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan. |
pricePercentage |
Persentase harga yang direpresentasikan sebagai angka dalam notasi desimal (Misalnya, |
carrierRate |
Nama tarif ekspedisi yang mengacu pada tarif ekspedisi yang ditentukan dalam grup tarif yang sama. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan. |
subtable |
Nama subtabel. Hanya dapat ditetapkan dalam sel tabel (Misalnya, bukan untuk nilai tunggal), dan hanya jika semua kolom lain tidak ditetapkan. |
Tabel
Tabel yang menentukan grup tarif, saat singleValue
tidak cukup ekspresif.
Representasi JSON |
---|
{ "rows": [ { object ( |
Kolom | |
---|---|
rows[] |
Wajib. Daftar baris yang menyusun tabel. Harus memiliki panjang yang sama dengan |
name |
Nama tabel. Diperlukan untuk subtabel, diabaikan untuk tabel utama. |
rowHeaders |
Wajib. Header baris tabel. |
columnHeaders |
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 jumlah hargaMicros = -1. Misalnya, |
weights[] |
Wajib. Daftar batas atas berat pesanan inklusif. Nilai bobot terakhir dapat menjadi tak terhingga dengan menetapkan jumlah hargaMicros = -1. Misalnya, |
numberOfItems[] |
Wajib. Daftar batas atas jumlah inklusif item. Nilai terakhir dapat berupa |
postalCodeGroupNames[] |
Wajib. Daftar nama grup pos. Nilai terakhir dapat berupa |
locations[] |
Wajib. Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lain belum 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 |
amountMicros |
Wajib. Berat direpresentasikan sebagai angka dalam mikro (1 juta mikro setara dengan satuan standar mata uang, misalnya, 1 kg = 1000000 mikro). Kolom ini juga dapat ditetapkan sebagai tak terhingga dengan menyetelnya ke -1. Kolom ini hanya mendukung nilai -1 dan positif. |
WeightUnit
Unit berat.
Enum | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unit belum ditentukan |
POUND |
satuan lb. |
KILOGRAM |
satuan kg. |
LocationIdSet
Daftar kumpulan ID lokasi. Tidak boleh kosong. Hanya dapat ditetapkan jika semua kolom lain belum ditetapkan.
Representasi JSON |
---|
{ "locationIds": [ string ] } |
Kolom | |
---|---|
locationIds[] |
Wajib. Daftar ID lokasi yang tidak kosong. Semuanya harus memiliki jenis lokasi yang sama (Misalnya, negara bagian). |
Baris
Menyertakan daftar sel.
Representasi JSON |
---|
{
"cells": [
{
object ( |
Kolom | |
---|---|
cells[] |
Wajib. Daftar sel yang menyusun baris. Harus memiliki panjang yang sama dengan |
CarrierRate
Daftar tarif ekspedisi yang dapat dirujuk oleh mainTable
atau singleValue
.
Representasi JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Kolom | |
---|---|
name |
Wajib. Nama tarif ekspedisi. Harus unik per grup tarif. |
carrier |
Wajib. Layanan ekspedisi, seperti |
carrierService |
Wajib. Layanan ekspedisi, seperti |
originPostalCode |
Wajib. Asal pengiriman untuk tarif ekspedisi ini. |
percentageAdjustment |
Opsional. Pengubah tarif pengiriman perkalian sebagai angka dalam notasi desimal. Bisa negatif. Misalnya, |
flatAdjustment |
Opsional. Pengubah tarif pengiriman tambahan. Bisa negatif. Misalnya, |
ShipmentType
Jenis pengiriman layanan pengiriman.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Layanan ini tidak memerinci jenis pengiriman. |
DELIVERY |
Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan. |
LOCAL_DELIVERY |
Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan. Pesanan dikirimkan dari toko lokal terdekat. |
COLLECTION_POINT |
Layanan ini mengirimkan pesanan ke alamat yang dipilih pelanggan. Pesanan akan dikirim dari lokasi pengambilan. |
MinimumOrderValueTable
Tabel nilai pesanan minimum per toko untuk jenis pemenuhan pesanan pengambilan.
Representasi JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Kolom | |
---|---|
storeCodeSetWithMovs[] |
Wajib. Daftar set kode toko dengan nilai pesanan minimum (MOV) yang sama. Setidaknya dua kumpulan diperlukan dan kumpulan terakhir harus kosong, yang menandakan 'MOV for all other store'. Setiap kode toko hanya dapat muncul sekali di semua kumpulan. Semua harga dalam layanan harus memiliki mata uang yang sama. |
StoreCodeSetWithMov
Daftar set kode toko dengan nilai pesanan minimum yang sama. Setidaknya dua kumpulan diperlukan dan kumpulan terakhir harus kosong, yang menandakan 'MOV for all other store'. Setiap kode toko hanya dapat muncul sekali di semua kumpulan. Semua harga dalam layanan harus memiliki mata uang yang sama.
Representasi JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
Kolom | |
---|---|
storeCodes[] |
Opsional. Daftar kode toko unik atau kosong untuk semua. |
value |
Nilai pesanan minimum untuk toko tertentu. |
StoreConfig
Daftar toko asal pengiriman produk Anda. Ini hanya berlaku untuk jenis pengiriman lokal.
Representasi JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Kolom | |
---|---|
storeCodes[] |
Opsional. Daftar kode toko yang menyediakan pengiriman lokal. Jika kosong, |
storeServiceType |
Menunjukkan apakah semua toko, atau toko yang dipilih, yang dicantumkan oleh penjual ini menyediakan pengiriman lokal. |
cutoffConfig |
Konfigurasi terkait pengiriman lokal berakhir pada hari itu. |
serviceRadius |
Radius pengiriman maksimum. Hal ini hanya diwajibkan untuk jenis pengiriman lokal. |
StoreServiceType
Menunjukkan apakah semua toko, atau toko yang dipilih, yang dicantumkan oleh penjual menyediakan pengiriman lokal.
Enum | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
Tidak menentukan jenis layanan toko. |
ALL_STORES |
Menunjukkan apakah semua toko, saat ini dan di masa mendatang, yang dicantumkan oleh penjual ini menyediakan pengiriman lokal. |
SELECTED_STORES |
Menunjukkan bahwa hanya toko yang tercantum di storeCodes yang memenuhi syarat untuk pengiriman lokal. |
CutoffConfig
Konfigurasi terkait pengiriman lokal berakhir pada hari tersebut.
Representasi JSON |
---|
{
"localCutoffTime": {
object ( |
Kolom | |
---|---|
localCutoffTime |
Waktu pengiriman lokal berakhir pada hari tersebut. |
storeCloseOffsetHours |
Hanya berlaku untuk pemenuhan pesanan pengiriman lokal. Menyatakan batas waktu sebagai jumlah jam sebelum tutup toko. Tidak dapat muncul bersamaan dengan |
noDeliveryPostCutoff |
Penjual dapat memilih untuk tidak menampilkan pengiriman lokal n+1 hari jika layanan pengiriman mereka dikonfigurasi untuk pengiriman lokal dalam n hari. Misalnya, jika layanan pengiriman menentukan pengiriman di hari yang sama, dan sudah melewati batas waktu, menetapkan kolom ini ke |
LocalCutoffTime
Waktu pengiriman lokal berakhir pada hari tersebut.
Representasi JSON |
---|
{ "hour": string, "minute": string } |
Kolom | |
---|---|
hour |
Jam pengiriman lokal untuk pesanan agar dapat diproses pada hari yang sama. |
minute |
Pesanan pengiriman lokal menit harus dilakukan untuk memproses hari yang sama. |
Jarak
Radius pengiriman maksimum. Hal ini hanya diwajibkan untuk jenis pengiriman lokal.
Representasi JSON |
---|
{
"value": string,
"unit": enum ( |
Kolom | |
---|---|
value |
Nilai jarak bilangan bulat. |
unit |
Unit dapat berbeda berdasarkan negara, diparameterisasi untuk menyertakan mil dan kilometer. |
Unit
Unit dapat berbeda berdasarkan negara, diparameterisasi untuk menyertakan mil dan kilometer.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unit belum ditetapkan |
MILES |
Unit dalam mil |
KILOMETERS |
Satuan dalam kilometer |
LoyaltyProgram
Program loyalitas yang disediakan oleh penjual.
Representasi JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Kolom | |
---|---|
loyaltyProgramTiers[] |
Opsional. Tingkat program loyalitas dari layanan pengiriman ini. |
programLabel |
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
Bagian dari program loyalitas penjual.
Representasi JSON |
---|
{ "tierLabel": string } |
Kolom | |
---|---|
tierLabel |
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 pengadaan, yang menyimpan dan menangani inventaris. Tag berikutnya: 7
Representasi JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Kolom | |
---|---|
name |
Wajib. Nama gudang. Harus unik dalam akun. |
shippingAddress |
Wajib. Alamat pengiriman gudang. |
cutoffTime |
Wajib. Waktu paling lambat saat pesanan dapat diterima dan mulai diproses. Pesanan akan diproses pada hari berikutnya. Waktu didasarkan pada kode pos gudang. |
handlingDays |
Wajib. Jumlah hari yang diperlukan gudang ini untuk mengemas dan mengirimkan barang. Hal ini berlaku di tingkat gudang, tetapi dapat diganti pada tingkat penawaran berdasarkan atribut item. |
businessDayConfig |
Hari kerja gudang. Jika tidak disetel, akan disetel ke Senin sampai Jumat secara default. |
Alamat
Alamat pengiriman gudang.
Representasi JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Kolom | |
---|---|
streetAddress |
Bagian tingkat jalan dari alamat. Misalnya: |
city |
Wajib. Kota besar, kota kecil, atau komune. Juga dapat mencakup lokalitas atau sublokalitas dependen (Misalnya kawasan atau pinggiran kota). |
administrativeArea |
Wajib. Subdivisi administratif tingkat teratas di negara tersebut. Misalnya, negara bagian seperti California ("CA") atau provinsi seperti Quebec ("QC"). |
postalCode |
Wajib. Kode pos atau kode pos (misalnya "94043"). |
regionCode |
Wajib. Kode negara CLDR (Misalnya "US"). |
WarehouseCutoffTime
Waktu paling lambat saat pesanan dapat diterima dan mulai diproses. Pesanan akan diproses pada hari berikutnya. Waktu didasarkan pada kode pos gudang.
Representasi JSON |
---|
{ "hour": integer, "minute": integer } |
Kolom | |
---|---|
hour |
Wajib. Jam dari batas waktu pesanan harus diproses pada hari yang sama oleh gudang. Jam didasarkan pada zona waktu gudang. |
minute |
Wajib. Menit batas waktu hingga pesanan harus diproses pada hari yang sama oleh gudang. Menit didasarkan pada zona waktu gudang. |