- Risorsa: ShippingSettings
- 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
- Metodi
Risorsa: ShippingSettings
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 dei servizi dell'account di destinazione. |
warehouses[] |
Facoltativo. Un elenco di magazzini a cui 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 | |
---|---|
delivery |
Obbligatorio. Il codice di territorio CLDR dei paesi a cui si applica il servizio. |
rate |
Facoltativo. Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un |
loyalty |
Facoltativo. Programmi fedeltà a cui è limitato questo servizio di spedizione. |
service |
Obbligatorio. Nome libero del servizio. Deve essere univoco all'interno dell'account di destinazione. |
active |
Obbligatorio. Un valore booleano che mostra lo stato attivo del servizio di spedizione. |
currency |
Il codice CLDR della valuta a cui si applica questo servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe. |
delivery |
Obbligatorio. Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto. |
shipment |
Tipo di località in cui questo servizio spedisce gli ordini. |
minimum |
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 a minimumOrderValueTable. |
minimum |
Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini con ritiro in negozio. Non può essere impostato insieme a minimumOrderValue. |
store |
Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di consegna locale. |
DeliveryTime
Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto.
Rappresentazione JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campi | |
---|---|
warehouse |
Facoltativo. 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 deve essere impostato nessun altro campo relativo al tempo di transito in [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min |
Numero minimo di giorni lavorativi di transito. 0 indica la consegna in giornata, 1 la consegna il giorno successivo. È necessario impostare |
max |
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 |
cutoff |
Definizione dell'ora limite per i giorni lavorativi. Se non è configurato, l'ora di interruzione sarà impostata su 08:00 PST. |
min |
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. |
max |
Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. Deve essere maggiore o uguale a |
transit |
Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi impostare |
handling |
I giorni lavorativi durante i quali è possibile gestire gli ordini. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì. |
transit |
I giorni lavorativi durante i quali gli ordini possono essere in transito. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì. |
CutoffTime
Definizione dell'ora limite per i giorni lavorativi.
Rappresentazione JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Campi | |
---|---|
hour |
Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga 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. |
time |
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 | |
---|---|
postal |
Obbligatorio. Un elenco di nomi di regioni |
transit |
Obbligatorio. Un elenco di etichette del tempo di transito. L'ultimo valore può essere |
rows[] |
Obbligatorio. Se è presente un solo insieme di dimensioni di |
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 | |
---|---|
min |
Intervallo di tempo di transito minimo in giorni lavorativi. 0 indica la consegna in giornata, 1 la consegna il giorno successivo. |
max |
Deve essere maggiore o uguale a |
BusinessDayConfig
Giorni lavorativi del magazzino.
Rappresentazione JSON |
---|
{
"businessDays": [
enum ( |
Campi | |
---|---|
business |
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 deve essere impostato nessun altro campo relativo al tempo di transito in deliveryTime
.
Rappresentazione JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Campi | |
---|---|
carrier |
Obbligatorio. Operatore, ad esempio |
carrier |
Obbligatorio. Servizio dell'operatore, 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". L'altro applicableShippingLabels
non deve sovrapporsi.
Rappresentazione JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campi | |
---|---|
applicable |
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 |
carrier |
Facoltativo. Un elenco di tariffe dell'operatore a cui è possibile fare riferimento tramite |
single |
Il valore del gruppo di tariffe (ad es. tariffa fissa 10 $). Può essere impostato solo se |
main |
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 valori noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
.
Rappresentazione JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Campi | |
---|---|
no |
Se il valore è true, il prodotto non può essere spedito. Deve essere true se impostato, può essere impostato solo se tutti gli altri campi non sono impostati. |
flat |
Una tariffa fissa. Può essere impostato solo se non sono impostati tutti gli altri campi. |
price |
Una percentuale del prezzo rappresentata come numero in notazione decimale (ad es. |
carrier |
Il 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 i singoli valori) e solo se non sono impostati tutti gli altri campi. |
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. |
row |
Obbligatorio. Intestazioni delle righe della tabella. |
column |
Intestazioni delle colonne della tabella. Facoltativo: se non impostato, 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 price amountMicros = -1. Ad esempio, |
weights[] |
Obbligatorio. Un elenco di limiti superiori del peso dell'ordine inclusivi. Il valore dell'ultimo peso può essere infinito impostando price amountMicros = -1. Ad esempio, |
number |
Obbligatorio. Un elenco di limiti superiori inclusivi del numero di articoli. L'ultimo valore può essere |
postal |
Obbligatorio. Un elenco di nomi di gruppi postali. L'ultimo valore può essere |
locations[] |
Obbligatorio. Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi. |
Peso
Il peso rappresentato come valore in stringa e unità.
Rappresentazione JSON |
---|
{
"unit": enum ( |
Campi | |
---|---|
unit |
Obbligatorio. L'unità di peso. I valori accettati sono: kg e lb |
amount |
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ò essere impostato anche su infinito impostando il valore -1. Questo campo supporta solo -1 e valori positivi. |
WeightUnit
L'unità di peso.
Enum | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
Unità non specificata |
POUND |
unità di misura lb. |
KILOGRAM |
unità di misura kg. |
LocationIdSet
Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.
Rappresentazione JSON |
---|
{ "locationIds": [ string ] } |
Campi | |
---|---|
location |
Obbligatorio. Un elenco non vuoto di ID posizione. 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
. I servizi di corrieri supportati sono definiti nella pagina 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.
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 dell'operatore, ad esempio |
carrier |
Obbligatorio. Servizio dell'operatore, ad esempio |
origin |
Obbligatorio. Origine della spedizione per questa tariffa del corriere. |
percentage |
Facoltativo. Modificatore della tariffa di spedizione moltiplicativo come numero in notazione decimale. Può essere negativo. Ad esempio, |
flat |
Facoltativo. Modificatore della tariffa di spedizione additivo. Può essere negativo. Ad esempio, |
ShipmentType
Tipo di spedizione del servizio di spedizione.
Enum | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Questo servizio non ha 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 con ritiro in negozio.
Rappresentazione JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campi | |
---|---|
store |
Obbligatorio. Un elenco di insiemi di codici identificativi del 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ò 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ò essere visualizzato 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 | |
---|---|
store |
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 | |
---|---|
store |
Facoltativo. Un elenco di codici negozio che offrono la consegna locale. Se vuoto, |
store |
Indica se tutti i negozi o negozi selezionati elencati da questo commerciante offrono la consegna locale. |
cutoff |
Le configurazioni relative alla consegna locale terminano per la giornata. |
service |
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 offrono 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 offrono la consegna locale. |
SELECTED_STORES |
Indica che solo i negozi elencati in storeCodes sono idonei per la consegna locale. |
CutoffConfig
Le configurazioni relative alla consegna locale terminano per la giornata.
Rappresentazione JSON |
---|
{
"localCutoffTime": {
object ( |
Campi | |
---|---|
local |
Ora di fine della consegna locale per la giornata. |
store |
Valido solo con l'evasione degli ordini locali. Rappresenta l'ora limite come numero di ore prima della chiusura del negozio. Si escludono a vicenda con |
no |
I commercianti possono disattivare la visualizzazione della consegna locale in n+1 giorni se hanno configurato un servizio di spedizione con consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed è trascorso il 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 devono essere effettuati entro questo orario 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 in modo da 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 | |
---|---|
loyalty |
Facoltativo. Livello del programma fedeltà di questo servizio di spedizione. |
program |
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 | |
---|---|
tier |
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 per l'evasione degli ordini, che gestisce e conserva l'inventario.
Rappresentazione JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome del magazzino. Deve essere univoco all'interno dell'account. |
shipping |
Obbligatorio. Indirizzo di spedizione del magazzino. |
cutoff |
Obbligatorio. 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. |
handling |
Obbligatorio. Il numero di giorni necessari a questo magazzino per imballare e spedire un articolo. Questo valore è a livello di magazzino, ma può essere ignorato a livello di offerta in base agli attributi di un articolo. |
business |
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 | |
---|---|
street |
La parte dell'indirizzo a livello di strada. Ad esempio: |
city |
Obbligatorio. Città, paese o comune. Può includere anche località o sottolocalità dipendenti (ad esempio quartieri o sobborghi). |
administrative |
Obbligatorio. Suddivisione amministrativa di primo livello del paese. Ad esempio, uno stato come la California ("CA") o una provincia come il Québec ("QC"). |
postal |
Obbligatorio. Codice postale (ad es. "94043"). |
region |
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. |
Metodi |
|
---|---|
|
Recupera le informazioni sulle impostazioni di spedizione. |
|
Sostituisci l'impostazione di spedizione di un commerciante con l'impostazione di richiesta di spedizione. |