- Rappresentazione JSON
- Servizio
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Giorno della settimana
- WarehouseBasedDeliveryTime
- RateGroup
- Conveniente
- Tabella
- Intestazioni
- Peso
- WeightUnit
- LocationIdSet
- Riga
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distanza
- Unità
- LoyaltyProgram
- LoyaltyProgramTiers
- Deposito
- Indirizzo
- WarehouseCutoffTime
L'[impostazione di spedizione]((https://support.google.com/merchants/answer/6069284) dell'account commerciante.
Rappresentazione JSON |
---|
{ "name": string, "services": [ { object ( |
Campi | |
---|---|
name |
Identificatore. Il nome della risorsa dell'impostazione di spedizione. Formato: |
services[] |
(Facoltativo) L'elenco di servizi dell'account di destinazione. |
warehouses[] |
(Facoltativo) Un elenco di warehouse a cui è possibile fare riferimento in |
etag |
Obbligatorio. Questo campo viene utilizzato per evitare problemi asincroni. Assicurati che i dati dell'impostazione di spedizione non siano cambiati tra la richiesta di ricezione e quella di inserimento della chiamata. L'utente deve procedere nel seguente modo:
|
Servizio
Servizio di spedizione.
Rappresentazione JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campi | |
---|---|
deliveryCountries[] |
Obbligatorio. Il codice di territorio CLDR dei paesi a cui si applica il servizio. |
rateGroups[] |
(Facoltativo) Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un campo |
loyaltyPrograms[] |
(Facoltativo) I programmi fedeltà a cui è limitato questo servizio di spedizione. |
serviceName |
Obbligatorio. Nome in formato libero del servizio. Deve essere univoco all'interno dell'account di destinazione. |
active |
Obbligatorio. Un valore booleano che indica lo stato attivo del servizio di spedizione. |
currencyCode |
Il codice CLDR della valuta a cui si applica il servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe. |
deliveryTime |
Obbligatorio. Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto. |
shipmentType |
Tipo di località in cui questo servizio spedisce gli ordini. |
minimumOrderValue |
Valore minimo dell'ordine per questo servizio. Se impostato, indica che i clienti dovranno spendere almeno questo importo. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. Non può essere impostato insieme aminimumOrderValueTable. |
minimumOrderValueTable |
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini di ritiro. Non può essere impostato insieme aminimumOrderValue. |
storeConfig |
Un elenco dei negozi dai quali vengono consegnati i tuoi prodotti. È valido solo per il tipo di spedizione con consegna locale. |
DeliveryTime
Tempo trascorso in vari aspetti, dall'ordine alla consegna del prodotto.
Rappresentazione JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campi | |
---|---|
warehouseBasedDeliveryTimes[] |
(Facoltativo) Indica che i tempi di consegna devono essere calcolati per magazzino (località di origine della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non è necessario impostare nessun altro campo relativo al tempo di transito in [tempo di consegna][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
minTransitDays |
Numero minimo di giorni lavorativi di transito. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. È necessario impostare |
maxTransitDays |
Numero massimo di giorni lavorativi trascorsi in transito. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. Deve essere maggiore o uguale a |
cutoffTime |
Definizione dell'orario limite nei giorni lavorativi. Se non viene configurato, l'orario limite verrà impostato in modo predefinito sulle 8:00 PST. |
minHandlingDays |
Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 significa che viene spedito lo stesso giorno, 1 significa che verrà spedito il giorno successivo. |
maxHandlingDays |
Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 significa che viene spedito lo stesso giorno, 1 significa che verrà spedito il giorno successivo. Deve essere maggiore o uguale a |
transitTimeTable |
Tabella del tempo di transito, numero di giorni lavorativi di transito in base alle dimensioni di riga e colonna. È possibile impostare |
handlingBusinessDayConfig |
I giorni lavorativi durante i quali è possibile gestire gli ordini. Se non viene specificato, vengono utilizzati i giorni lavorativi dal lunedì al venerdì. |
transitBusinessDayConfig |
I giorni lavorativi durante i quali gli ordini possono essere in transito. Se non viene specificato, vengono utilizzati i giorni lavorativi dal lunedì al venerdì. |
CutoffTime
Definizione dell'orario limite nei giorni lavorativi.
Rappresentazione JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno. |
minute |
Obbligatorio. Minuto dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno. |
timeZone |
Obbligatorio. Identificatore del fuso orario, ad esempio "Europa/Zurigo". |
TransitTable
Tabella del tempo di transito, numero di giorni lavorativi di transito in base alle dimensioni di riga e colonna. È possibile impostare minTransitDays
, maxTransitDays
o transitTimeTable
, ma non entrambi.
Rappresentazione JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Campi | |
---|---|
postalCodeGroupNames[] |
Obbligatorio. Un elenco di nomi di regioni |
transitTimeLabels[] |
Obbligatorio. Un elenco di etichette del tempo di transito. L'ultimo valore può essere |
rows[] |
Obbligatorio. Se è presente un solo insieme di dimensioni |
TransitTimeRow
Se è presente un solo insieme di dimensioni postalCodeGroupNames
o transitTimeLabels
, sono presenti più righe, ciascuna con un valore per quella dimensione. Se sono presenti due dimensioni, ogni riga corrisponde a un postalCodeGroupNames
e le colonne (valori) a un transitTimeLabels
.
Rappresentazione JSON |
---|
{
"values": [
{
object ( |
Campi | |
---|---|
values[] |
Obbligatorio. Intervallo del tempo di transito (min-max) in giorni lavorativi. |
TransitTimeValue
Intervallo del tempo di transito (min-max) in giorni lavorativi.
Rappresentazione JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Campi | |
---|---|
minTransitDays |
Intervallo di tempo di transito minimo in giorni lavorativi. 0 significa la consegna in giornata, 1 significa la consegna il giorno successivo. |
maxTransitDays |
Deve essere maggiore o uguale a |
BusinessDayConfig
Giorni lavorativi del magazzino.
Rappresentazione JSON |
---|
{
"businessDays": [
enum ( |
Campi | |
---|---|
businessDays[] |
Obbligatorio. Giorni lavorativi normali. Il campo non può essere vuoto. |
Giorno feriale
Enum | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
Indica che i tempi di consegna devono essere calcolati per magazzino (località di origine della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non è necessario impostare altri campi relativi al tempo di transito in deliveryTime
.
Rappresentazione JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Campi | |
---|---|
carrier |
Obbligatorio. Operatore, ad esempio |
carrierService |
Obbligatorio. Servizio del corriere, ad esempio |
warehouse |
Obbligatorio. Nome warehouse. Deve corrispondere a [warehouse][ShippingSetting.warehouses.name]. |
RateGroup
Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un campo applicableShippingLabels
vuoto, che significa "tutto il resto". Gli altri applicableShippingLabels
non devono sovrapporsi.
Rappresentazione JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campi | |
---|---|
applicableShippingLabels[] |
Obbligatorio. Un elenco di etichette di spedizione che definiscono i prodotti a cui si applica questo gruppo di tariffe. Questa è una disgiunzione: solo una delle etichette deve corrispondere affinché il gruppo di tariffe venga applicato. Può essere vuoto solo per l'ultimo gruppo di tariffe di un servizio. |
subtables[] |
(Facoltativo) Un elenco di sottotabelle a cui fa riferimento |
carrierRates[] |
(Facoltativo) Un elenco di tariffe del corriere a cui |
singleValue |
Il valore del gruppo di tariffe (ad esempio, costo fisso 10 $). Può essere impostato solo se i criteri |
mainTable |
Una tabella che definisce il gruppo di tariffe, quando |
name |
(Facoltativo) Nome del gruppo di tariffe. Se impostato deve essere univoco all'interno del servizio di spedizione. |
Valore
Valore singolo di un gruppo di tariffe o valore della cella della tabella di un gruppo di tariffe. Deve essere impostato esattamente uno dei seguenti valori: noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
.
Rappresentazione JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Campi | |
---|---|
noShipping |
In questo caso, il prodotto non può essere spedito. Il valore deve essere true se viene impostato. Può essere impostato solo se tutti gli altri campi non sono impostati. |
flatRate |
Costo fisso. Può essere impostato solo se tutti gli altri campi non sono impostati. |
pricePercentage |
Una percentuale del prezzo rappresentata da un numero in notazione decimale (ad esempio, |
carrierRate |
Nome di una tariffa del corriere che fa riferimento a una tariffa del corriere definita nello stesso gruppo di tariffe. Può essere impostato solo se tutti gli altri campi non sono impostati. |
subtable |
Il nome di una sottotabella. Può essere impostato solo nelle celle della tabella (ad esempio, non per singoli valori) e solo se tutti gli altri campi non sono impostati. |
Tabella
Una tabella che definisce il gruppo di tariffe, quando singleValue
non è abbastanza espressivo.
Rappresentazione JSON |
---|
{ "rows": [ { object ( |
Campi | |
---|---|
rows[] |
Obbligatorio. L'elenco di righe che costituiscono la tabella. Deve avere la stessa lunghezza di |
name |
Nome della tabella. Obbligatorio per le sottotabelle, ignorato per la tabella principale. |
rowHeaders |
Obbligatorio. Intestazioni delle righe della tabella. |
columnHeaders |
Intestazioni delle colonne della tabella. (Facoltativo) Se non è impostata, la tabella ha una sola dimensione. |
Intestazioni
Un elenco non vuoto di intestazioni di riga o colonna per una tabella. Deve essere impostato esattamente uno dei seguenti valori: prices
, weights
, num_items
, postalCodeGroupNames
o location
.
Rappresentazione JSON |
---|
{ "prices": [ { object ( |
Campi | |
---|---|
prices[] |
Obbligatorio. Un elenco di limiti superiori del prezzo dell'ordine inclusivo. Il valore dell'ultimo prezzo può essere infinito impostando l'importo del prezzo Micros = -1. Ad esempio |
weights[] |
Obbligatorio. Un elenco di limiti superiori inclusivi del peso dell'ordine. Il valore dell'ultimo peso può essere infinito impostando price amountMicros = -1. Ad esempio |
numberOfItems[] |
Obbligatorio. Un elenco di un numero comprensivo di limiti superiori di elementi. L'ultimo valore può essere |
postalCodeGroupNames[] |
Obbligatorio. Un elenco di nomi di gruppi postali. L'ultimo valore può essere |
locations[] |
Obbligatorio. Un elenco di insiemi di ID località. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati. |
Peso
La ponderazione rappresentata come valore nella stringa e nell'unità.
Rappresentazione JSON |
---|
{
"unit": enum ( |
Campi | |
---|---|
unit |
Obbligatorio. L'unità di peso. I valori accettati sono: kg e lb |
amountMicros |
Obbligatorio. Il peso rappresentato come numero in micro (1 milione di micro è equivalente all'unità standard di una valuta, ad esempio 1 kg = 1000000 micro). Questo campo può anche essere impostato come infinito su -1. Questo campo supporta solo -1 e valori positivi. |
WeightUnit
L'unità di peso.
Enum | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unità non specificata |
POUND |
lb. |
KILOGRAM |
kg. |
LocationIdSet
Un elenco di insiemi di ID località. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati.
Rappresentazione JSON |
---|
{ "locationIds": [ string ] } |
Campi | |
---|---|
locationIds[] |
Obbligatorio. Un elenco non vuoto di ID località. Devono essere tutti dello stesso tipo di località (ad esempio, stato). |
Riga
Includi un elenco di celle.
Rappresentazione JSON |
---|
{
"cells": [
{
object ( |
Campi | |
---|---|
cells[] |
Obbligatorio. L'elenco di celle che costituiscono la riga. Deve avere la stessa lunghezza di |
CarrierRate
Un elenco di tariffe del corriere a cui mainTable
o singleValue
può fare riferimento.
Rappresentazione JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Campi | |
---|---|
name |
Obbligatorio. Nome della tariffa del corriere. Deve essere univoco per ogni gruppo di tariffe. |
carrier |
Obbligatorio. Servizio del corriere, ad esempio |
carrierService |
Obbligatorio. Servizio del corriere, ad esempio |
originPostalCode |
Obbligatorio. Origine della spedizione per questa tariffa del corriere. |
percentageAdjustment |
(Facoltativo) Modificatore moltiplicativo per la tariffa di spedizione come numero in notazione decimale. Può essere negativo. Ad esempio, |
flatAdjustment |
(Facoltativo) Modificatore di tariffa di spedizione additivo. Può essere negativo. Ad esempio, |
ShipmentType
Tipo di servizio di spedizione.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Per questo servizio non è stato specificato il tipo di spedizione. |
DELIVERY |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. |
LOCAL_DELIVERY |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un negozio locale nelle vicinanze. |
COLLECTION_POINT |
Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un punto di ritiro. |
MinimumOrderValueTable
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini di ritiro.
Rappresentazione JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campi | |
---|---|
storeCodeSetWithMovs[] |
Obbligatorio. Un elenco di insiemi di codici negozio che condividono lo stesso valore minimo dell'ordine (MOV). Sono obbligatori almeno due insiemi e l'ultimo deve essere vuoto, a indicare che si tratta di "MOV for all other stores". Ogni codice negozio può apparire una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. |
StoreCodeSetWithMov
Un elenco di insiemi di codici negozio che condividono lo stesso valore minimo dell'ordine. Sono obbligatori almeno due insiemi e l'ultimo deve essere vuoto, a indicare che si tratta di "MOV for all other stores". Ogni codice negozio può apparire una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta.
Rappresentazione JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
Campi | |
---|---|
storeCodes[] |
(Facoltativo) Un elenco di codici negozio univoci o vuoto per il campo catch all. |
value |
Il valore minimo dell'ordine per i negozi specificati. |
StoreConfig
Un elenco dei negozi dai quali vengono consegnati i tuoi prodotti. È valido solo per il tipo di spedizione con consegna locale.
Rappresentazione JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Campi | |
---|---|
storeCodes[] |
(Facoltativo) Un elenco di codici negozio che offrono la consegna locale. Se vuoto, |
storeServiceType |
Indica se tutti i negozi, o negozi selezionati, elencati da questo commerciante forniscono la consegna locale. |
cutoffConfig |
Le configurazioni relative alla consegna locale terminano questa giornata. |
serviceRadius |
Raggio di consegna massimo. Questa operazione è necessaria solo per il tipo di spedizione con consegna locale. |
StoreServiceType
Indica se tutti i negozi, o negozi selezionati, elencati dal commerciante forniscono la consegna locale.
Enum | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
Non è stato specificato il tipo di servizio del negozio. |
ALL_STORES |
Indica se tutti i negozi, attuali e futuri, elencati da questo commerciante forniscono la consegna locale. |
SELECTED_STORES |
Indica che solo i negozi elencati in storeCodes sono idonei alla consegna locale. |
CutoffConfig
Le configurazioni relative alla consegna locale terminano questa giornata.
Rappresentazione JSON |
---|
{
"localCutoffTime": {
object ( |
Campi | |
---|---|
localCutoffTime |
Ora di fine della consegna locale nel corso della giornata. |
storeCloseOffsetHours |
Valido solo con evasione della consegna locale. Rappresenta l'orario limite come numero di ore prima della chiusura del negozio. Si escludono a vicenda con |
noDeliveryPostCutoff |
I commercianti possono disattivare la visualizzazione della consegna locale in n più giorni se hanno un servizio di spedizione configurato per la consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed ha superato l'orario limite, l'impostazione di questo campo su |
LocalCutoffTime
Ora di fine della consegna locale nel corso della giornata.
Rappresentazione JSON |
---|
{ "hour": string, "minute": string } |
Campi | |
---|---|
hour |
Gli ordini con consegna locale a un'ora devono essere effettuati entro per l'elaborazione nello stesso giorno. |
minute |
Gli ordini con consegna locale in minuti devono essere effettuati entro per essere elaborati lo stesso giorno. |
Distanza
Raggio di consegna massimo. Questa operazione è necessaria solo per il tipo di spedizione con consegna locale.
Rappresentazione JSON |
---|
{
"value": string,
"unit": enum ( |
Campi | |
---|---|
value |
Valore intero della distanza. |
unit |
L'unità può variare in base al paese ed è parametrizzata per includere miglia e chilometri. |
Unità
L'unità può variare in base al paese ed è parametrizzata per includere miglia e chilometri.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unità non specificata |
MILES |
Unità in miglia |
KILOMETERS |
Unità in chilometri |
LoyaltyProgram
Programma fedeltà fornito da un commerciante.
Rappresentazione JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Campi | |
---|---|
loyaltyProgramTiers[] |
(Facoltativo) Livello del programma fedeltà di questo servizio di spedizione. |
programLabel |
Questa è l'etichetta del programma fedeltà configurata nelle relative impostazioni in Merchant Center. Questo attributo secondario consente a Google di mappare il tuo programma fedeltà alle offerte idonee. |
LoyaltyProgramTiers
Sottoinsieme di un programma fedeltà dei commercianti.
Rappresentazione JSON |
---|
{ "tierLabel": string } |
Campi | |
---|---|
tierLabel |
L'attributo secondario etichetta del livello [tierLabel] differenzia i vantaggi di ciascun livello dell'offerta. Questo valore è configurato anche nelle impostazioni del programma in Merchant Center ed è obbligatorio per le modifiche all'origine dati anche se il programma fedeltà ha un solo livello. |
Deposito
Un magazzino di distribuzione, che archivia e gestisce l'inventario. Tag successivo: 7
Rappresentazione JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome del magazzino. Deve essere univoco all'interno dell'account. |
shippingAddress |
Obbligatorio. Indirizzo di spedizione del magazzino. |
cutoffTime |
Obbligatorio. L'ultima ora del giorno in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati nel giorno successivo. L'ora si basa sul codice postale del magazzino. |
handlingDays |
Obbligatorio. Il numero di giorni necessari per imballare e spedire un articolo in questo magazzino. È a livello di magazzino, ma può essere sostituito a livello di offerta in base agli attributi di un articolo. |
businessDayConfig |
Giorni lavorativi del magazzino. Se non viene configurato, per impostazione predefinita sarà da lunedì a venerdì. |
Indirizzo
Indirizzo di spedizione del magazzino.
Rappresentazione JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Campi | |
---|---|
streetAddress |
Parte dell'indirizzo a livello stradale. Ad esempio: |
city |
Obbligatorio. Città, paese o comune. Può includere anche località dipendenti o zone secondarie (ad esempio quartieri o sobborghi). |
administrativeArea |
Obbligatorio. Suddivisione amministrativa di primo livello del paese. Ad esempio, uno stato come la California ("CA") o una provincia come il Québec ("QC"). |
postalCode |
Obbligatorio. Codice postale (ad esempio "94043"). |
regionCode |
Obbligatorio. Codice paese CLDR (ad es. "US"). |
WarehouseCutoffTime
L'ultima ora del giorno in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati nel giorno successivo. L'ora si basa sul codice postale del magazzino.
Rappresentazione JSON |
---|
{ "hour": integer, "minute": integer } |
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno dal magazzino. L'ora si basa sul fuso orario del magazzino. |
minute |
Obbligatorio. Minuto dell'orario limite fino al quale deve essere effettuato un ordine per essere elaborato nello stesso giorno dal magazzino. I minuti sono basati sul fuso orario del magazzino. |