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

La risorsa ShippingSettings ti consente di recuperare e aggiornare le impostazioni di spedizione del tuo account e di tutti i subaccount associati. Per ulteriori informazioni su come aggiungere o gestire le impostazioni di spedizione del tuo account, consulta la Panoramica delle impostazioni di spedizione.

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

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

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

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

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

Per ulteriori informazioni, consulta Metodo: accounts.shippingSettings.insert.

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

Di seguito è riportato un confronto di esempio tra l'API Content for Shopping e l'API Impostazioni di spedizione del commerciante:

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

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

1. Gli utenti dell'API Merchant devono inserire accounts/{ACCOUNT_ID}/shippingSettings nel campo {NAME} per ottenere lo stesso comportamento.
2. L'API Merchant non supporta le operazioni di lettura e scrittura nelle aree personalizzate, come i gruppi di sedi. Le aree personalizzate come i gruppi di località possono essere lette o scritte solo utilizzando il servizio di regione.
3. Il modo in cui configurare WarehouseBasedDeliveryTime è diverso per l'API Merchant rispetto all'API Content for Shopping. Se utilizzi l'API Merchant, devi definire le informazioni sul magazzino in shippingsettings.warehouses. Ogni servizio di spedizione può 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 Impostazioni di spedizione del commerciante supporta i seguenti nuovi campi rispetto all'API Content for Shopping:

1. Magazzini: fornisce informazioni su un magazzino di evasione degli ordini, che immagazzina e gestisce l'inventario.
2. Programmi fedeltà: gli utenti dell'API Merchant possono inserire le informazioni del programma fedeltà nelle loro impostazioni di spedizione.
3. Etag: l'Etag è progettato per risolvere i problemi di aggiornamento asincrono quando utenti diversi tentano di aggiornare le impostazioni di spedizione utilizzando contemporaneamente l'API Merchant e l'interfaccia utente di Merchant Center.

Campi rinominati

I seguenti campi sono stati rinominati nell'API Merchant:

API Content per Shopping	API Shipping Settings di Merchant	Descrizione
service	services	Un unico servizio di spedizione.
service.name	services.serviceName	Nome libero del servizio 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 questo servizio.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Numero minimo di giorni lavorativi di transito di un ordine. Ad esempio, 0 indica la consegna in giornata e 1 la consegna il giorno successivo.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Numero massimo di giorni lavorativi che un ordine trascorre in transito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identificatore del fuso orario per l'ora 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 di tariffe dell'operatore.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Un elenco di set di codici negozio che condividono lo stesso valore minimo dell'ordine.

Metodi ritirati

Non puoi utilizzare shippingsettings.custombatch per recuperare e aggiornare le impostazioni di spedizione di più account in un'unica richiesta.

Campi deprecati

I seguenti campi dell'API Content sono deprecati nell'API Merchant. L'API Merchant non fornisce alcuna alternativa per questi campi.

• postal_code_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

Di seguito è riportato un confronto dei metodi nell'API Content for Shopping e nell'API Merchant Shipping Settings:

Metodo	API Content per Shopping	API Merchant
customBatch	Sì	No
get	Sì	Sì
update	Sì	No
insert	No	Sì
getSupportedCarrier	Sì	No
getSupportedHolidays	Sì	No