- Rappresentazione JSON
- Servizio
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Giorno della settimana
- WarehouseBasedDeliveryTime
- RateGroup
- Valore
- Table
- Intestazioni
- Peso
- WeightUnit
- LocationIdSet
- Riga
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distanza
- Unità
- LoyaltyProgram
- LoyaltyProgramTiers
- Magazzino
- Indirizzo
- WarehouseCutoffTime
Le impostazioni di spedizione 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 di accoppiamento asincrono. Assicurati che i dati delle impostazioni di spedizione non siano cambiati tra la chiamata get e la chiamata insert. L'utente deve seguire i seguenti passaggi:
|
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 |
loyaltyPrograms[] |
(Facoltativo) 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 impiegato per 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 al valoreminimumOrderValue. |
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 di transito. 0 indica la consegna in giornata, 1 la consegna il giorno successivo. Deve essere maggiore o uguale a |
cutoffTime |
Definizione dell'orario limite nei giorni lavorativi. Se non è configurato, l'ora di interruzione sarà impostata su 08:00 PST. |
minHandlingDays |
Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. "minHandlingDays" e "maxHandlingDays" devono essere impostati o non impostati contemporaneamente. |
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 fornito, si presume che i giorni lavorativi siano 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 entro il quale deve essere effettuato un ordine per consentirne l'elaborazione nello stesso giorno. |
timeZone |
Obbligatorio. Identificatore del fuso orario, ad esempio "Europe/Zurich". |
TransitTable
Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi 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 di postalCodeGroupNames
o transitTimeLabels
, esistono più righe con un valore per ogni 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 di tempo di transito (min-max) in giorni lavorativi. |
TransitTimeValue
Intervallo di 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 indica la consegna in giornata, 1 indica 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 regolari. Non può essere vuoto. |
Giorno feriale
Enum | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
Indica che il tempo di consegna deve essere calcolato in base al magazzino (luogo di partenza 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 del magazzino. Deve corrispondere a [warehouse][ShippingSetting.warehouses.name] |
RateGroup
Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un 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. Si tratta di una disgiunzione: per l'applicazione del gruppo di tariffe è sufficiente che corrisponda una delle etichette. 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 dell'operatore a cui è possibile fare riferimento tramite |
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
Il singolo valore di un gruppo di tariffe o il valore della cella di una tabella di gruppi 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 |
Se "true", 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 |
Una tariffa fissa. Può essere impostato solo se non sono impostati tutti gli altri campi. |
pricePercentage |
Una percentuale del prezzo rappresentata come numero in notazione decimale (ad es. |
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 non sono impostati tutti gli altri campi. |
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 è sufficientemente 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 valori prices
, weights
, num_items
, postalCodeGroupNames
o location
.
Rappresentazione JSON |
---|
{ "prices": [ { object ( |
Campi | |
---|---|
prices[] |
Obbligatorio. Un elenco di limiti superiori del prezzo dell'ordine inclusi. 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 limiti superiori inclusivi del numero di articoli. 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 posizione. Il campo non può essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi. |
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à di misura standard della 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à. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.
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 dell'operatore a cui è possibile fare riferimento tramite mainTable
o singleValue
.
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 tariffario. |
carrier |
Obbligatorio. Servizio del corriere, ad esempio |
carrierService |
Obbligatorio. Servizio dell'operatore, ad esempio |
originPostalCode |
Obbligatorio. L'origine della spedizione per questa tariffa del corriere. |
percentageAdjustment |
(Facoltativo) Modificatore della tariffa di spedizione moltiplicativo come numero in notazione decimale. Può essere negativo. Ad esempio, |
flatAdjustment |
(Facoltativo) Modificatore della tariffa di spedizione additivo. Può essere negativo. Ad esempio, |
ShipmentType
Tipo di spedizione del 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ò essere visualizzato una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. |
StoreCodeSetWithMov
Un elenco di set di codici negozio che condividono lo stesso valore minimo dell'ordine. Sono necessari almeno due insiemi e l'ultimo deve essere vuoto, il che significa "MOV per tutti gli altri negozi". 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 valore generico. |
value |
Il valore minimo dell'ordine per i negozi specificati. |
StoreConfig
Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di 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 per la giornata. |
serviceRadius |
Raggio di consegna massimo. Questo requisito è obbligatorio 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 per la giornata.
Rappresentazione JSON |
---|
{
"localCutoffTime": {
object ( |
Campi | |
---|---|
localCutoffTime |
L'ora di fine della giornata in cui termina la consegna locale. |
storeCloseOffsetHours |
Valido solo con evasione della consegna locale. Rappresenta l'ora 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 per la giornata.
Rappresentazione JSON |
---|
{ "hour": string, "minute": string } |
Campi | |
---|---|
hour |
Gli ordini con consegna locale devono essere effettuati entro questa ora per essere elaborati lo 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. Questo requisito è obbligatorio 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 in modo da 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 |
Si tratta dell'etichetta del programma fedeltà impostata nelle impostazioni del programma fedeltà 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 alle origini dati anche se il programma fedeltà ha un solo livello. |
Deposito
Un magazzino di evasione degli ordini, che gestisce e conserva 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 a questo magazzino per imballare e spedire un articolo. Questo valore è 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 è impostato, per impostazione predefinita sarà dal lunedì al venerdì. |
Indirizzo
Indirizzo di spedizione del magazzino.
Rappresentazione JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Campi | |
---|---|
streetAddress |
La parte dell'indirizzo a livello di strada. Ad esempio: |
city |
Obbligatorio. Città, paese o comune. Possono essere incluse anche località o sottolocalità dipendenti (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'ora più tardi in cui è possibile accettare un ordine e iniziare l'elaborazione. Gli ordini successivi verranno elaborati il giorno successivo. L'ora si basa sul codice postale del magazzino.
Rappresentazione JSON |
---|
{ "hour": integer, "minute": integer } |
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. L'ora si basa sul fuso orario del magazzino. |
minute |
Obbligatorio. Minuto dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. Il minuto si basa sul fuso orario del magazzino. |