Panoramica delle impostazioni di spedizione

La ShippingSettings risorsa consente di recuperare e aggiornare le impostazioni di spedizione del tuo account.

Nota: la risorsa shippingsettings non funziona per le impostazioni di spedizione create tramite il collegamento degli account o il caricamento manuale della cronologia relativa al monitoraggio degli ordini. Quelli le impostazioni di spedizione non verranno restituite, modificate o eliminate dalle chiamate a questo endpoint.

Google può aggiornare automaticamente i tempi di consegna stimati per alcuni prodotti. Per ulteriori informazioni, consulta la sezione Abilitare miglioramenti.

Leggere, scrivere o aggiornare le impostazioni di spedizione

Per utilizzare il servizio di spedizione dell'API Merchant:

1. Effettua una richiesta GET per recuperare le impostazioni di spedizione complete del tuo .
2. Modifica le impostazioni di spedizione.
3. Effettua una richiesta INSERT con le impostazioni di spedizione modificate.

ETag

L'Etag è un token codificato per evitare aggiornamenti asincroni. L'etag cambia quando modifiche ai dati delle impostazioni di spedizione. Gli utenti devono copiare l'etag ottenuto dalla richiesta GET al corpo della richiesta INSERT.

Se i dati delle impostazioni di spedizione cambiano tra la richiesta GET e i INSERT ricevi un messaggio di errore con la richiesta di un'altra richiesta GET a recupera il token etag più recente. Devi chiamare la richiesta GET al recupera il nuovo token etag e copialo nella richiesta INSERT del testo.

Aggiungi le tue impostazioni di spedizione

Utilizza shippingsettings.insert per aggiungere o aggiornare le impostazioni di spedizione per il tuo . Ecco una richiesta di esempio che aggiorna maxTransitDays in 7 per un Servizio di spedizione denominato Spedizione GSA - Spedizione gratuita oltre 49,99 $, sotto account 10:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

Importante: il corpo della richiesta INSERT deve contenere il corpo completo della risorsa la risorsa shippingsettings anche se stai solo aggiornando un singolo , poiché qualsiasi valore NULL o mancante nel corpo della richiesta restituisce i valori esistenti da annullare.

Imposta warehouse

Il seguente esempio JSON mostra come utilizzare le impostazioni di spedizione del commerciante per gestire le informazioni sul magazzino per il tuo account commerciante:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

Sostituisci quanto segue:

• {street_address}: parte a livello stradale dell'indirizzo del magazzino.
• {city}: città, paese o comune in cui si trova il magazzino.
• {administrative_area}: la suddivisione amministrativa del paese. Ad esempio, uno stato.
• {postal_code}: il codice postale.
• {region_code}: il codice paese nella stringa.
• {minutes}: minuti parte dell'orario limite fino ai quali l'ordine deve essere effettuato per essere elaborato lo stesso giorno dal magazzino.
• {handling_days}: il numero di giorni necessari magazzino per imballare e spedire un articolo.

La risorsa warehouses è un elenco di warehouse. Ogni warehouse può essere indicati dai tempi di consegna in base al magazzino del servizio di spedizione tramite warehouse.name.

Gestire i magazzini

Ecco come utilizzare l'API Merchant per gestire i tuoi magazzini:

1. Effettua una richiesta GET per recuperare tutti i tuoi dati shippingsettings e di container.

2. Copia il valore shippingsettings dalla richiesta GET alla richiesta UPDATE.

   Nota: se non copi tutti i shippingsettings esistenti, verranno eliminati dal tuo account nella richiesta INSERT.

3. Compila i warehouse se vuoi utilizzarli nella sezione warehouses per la richiesta INSERT.

4. Effettua una richiesta UPDATE contenente shippingsettings e warehouses Google Cloud.

Ecco un esempio di corpo della richiesta INSERT con warehouse per Warehouse 1 aggiornato da New York a Mountain View:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

Aggiungi la consegna in giornata

Puoi utilizzare l'API Content for Shopping per configurare la spedizione con consegna in giornata se disponi di un inventario locale. I servizi di spedizione con consegna in giornata hanno local_delivery come shipment_type. Tutte le spese di spedizione di local_delivery sono considerati consegne in giornata.

Non puoi modificare le informazioni delivery_time per le consegne locali. Utilizza le funzionalità di shippingsettings.insert per configurare la consegna in giornata per il tuo inventario locale prodotti di big data e machine learning.

Ecco un esempio di corpo della richiesta che aggiunge un servizio di consegna in giornata a tutti i negozi per il tuo account:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

Aggiungi la consegna il giorno successivo

Gli ordini emessi dopo l'orario limite per la consegna in giornata sono pianificati per il successivo per impostazione predefinita. Per disattivare la consegna il giorno successivo, imposta la no_delivery_post_cutoff su true. Se disattivi la consegna il giorno successivo, i servizi di spedizione sono visibili solo prima dell'orario limite ogni giorno.

La consegna il giorno successivo è disponibile soltanto quando shipment_type è local_delivery.

Scopri di più

Per scoprire di più sulla migrazione dall'API Content for Shopping, consulta Eseguire la migrazione della spedizione e la gestione delle impostazioni.