Eseguire la migrazione delle impostazioni di spedizione dall'API Content for Shopping

Per utilizzare l'API Merchant Center per leggere le informazioni sulle impostazioni di spedizione, utilizza le seguenti richieste:

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

Sostituisci {accountId} con l'identificatore univoco del tuo account Merchant Center.

Per utilizzare l'API Merchant Center per leggere le informazioni sulle impostazioni di spedizione, utilizza le seguenti richieste:

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

Confronto tra l'API Content for Shopping e l'API Merchant

Ecco un esempio di confronto tra l'API Content for Shopping e l'API Merchant Shipping Settings:

	API Content	API Merchant Center
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Identificatori	{accountId}/shippingsettings/{accountId}	{name}

Il seguente elenco menziona gli aggiornamenti principali dell'API Merchant Shipping Settings rispetto all'API Content for Shopping:

1. Gli utenti dell'API Merchant devono inserire accounts/{accountId}/shippingSettings nel campo {name} per avere lo stesso comportamento.
2. L'API Merchant Center non supporta le operazioni di lettura e scrittura su aree personalizzate, come i gruppi di località. Le aree personalizzate come i gruppi di località possono essere lette o scritte utilizzando il servizio regione.
3. La modalità di configurazione di WarehouseBasedDeliveryTime per l'API Merchant è diverso dall'API Content for Shopping. Se utilizzi l'API Merchant, devi definire le informazioni del magazzino in shippingsettings.warehouses. Ogni servizio di spedizione può quindi fare riferimento al magazzino tramite il nome del magazzino in warehouseBaseDeliveryTime.
4. Un servizio nell'API Merchant supporta più paesi di consegna.

Nuovi campi supportati

L'API Merchant Shipping Settings supporta i seguenti nuovi campi rispetto all'API Content for Shopping:

1. Magazzini: fornisce informazioni su un warehouse di evasione degli ordini, che archivia e gestisce l'inventario.
2. Programmi fedeltà: gli utenti dell'API Merchant possono inserire informazioni sul programma fedeltà nelle impostazioni di spedizione.
3. Esempio: Etag è progettato per risolvere i problemi asincroni quando diversi utenti tentano di aggiornare le impostazioni di spedizione utilizzando contemporaneamente l'API Merchant Center e la UI di Merchant Center.

Campi rinominati

I seguenti campi sono stati rinominati nell'API Merchant:

API Content per Shopping	API Merchant Shipping Settings	Descrizione
service	services	Un unico servizio di spedizione.
service.name	services.serviceName	Nome del servizio in formato libero, che deve essere univoco all'interno del tuo account Merchant Center.
service.deliveryCountry	services.deliveryCountries	Il codice di territorio CLDR del paese a cui si applica il servizio di spedizione.
service.currency	services.currencyCode	Il codice CLDR della valuta a cui si applica il servizio.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Numero minimo di giorni lavorativi in cui un ordine viene speso in transito. Ad esempio, 0 indica la consegna in giornata e 1 indica la consegna il giorno successivo.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Numero massimo di giorni lavorativi in cui un ordine viene speso in transito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Numero minimo di giorni lavorativi trascorsi prima della spedizione dell'ordine.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Numero massimo di giorni lavorativi trascorsi prima che un ordine venga spedito.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identificatore del fuso orario per l'orario limite.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	Il nome del gruppo di codici postali.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	L'etichetta del tempo di transito del prodotto.
service.rate_group	services.rateGroups	Definizioni dei gruppi di tariffe di spedizione.
service.rate_group.subtable	services.rateGroups.subtables	Un elenco di sottotabelle.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Un elenco delle tariffe del corriere.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Un elenco di set di codici negozio che condividono lo stesso valore minimo dell'ordine.

Metodi deprecati

Non puoi utilizzare shippingsettings.custombatch per recuperare e aggiornare le impostazioni di spedizione di più account in una singola richiesta.

Campi deprecati

I seguenti campi sono deprecati nell'API Merchant. Tieni presente che l'API Merchant non offre alternative per questi campi.

API Content per Shopping	API Merchant Center
postal_code_group	region
service Pickup_service Eligibility Scheduling_channel Delivery_time Holiday_cutoff Min_scheduling_time_in_days Max_scheduling_time_in_days Scheduling_business_day_config Rate_group |service: Pickup_service - Eligibility - Scheduling_channel - Delivery_time - Holiday_cutoff - Min_scheduling_time_in_days - Max_scheduling_time_in_days - Scheduling_business_day_config - Rate_group - single_value_alternative_list Metodi Ecco un confronto dei metodi nell'API Content for Shopping e nell'API Merchant Shipping Settings: Metodo API Content per Shopping API Merchant Center customBatch Sì No get Sì Sì update Sì No insert No Sì getSupportedCarrier Sì No getSupportedHolidays Sì No