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 saperne di più 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/v1/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/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

Per ulteriori informazioni, consulta Metodo: accounts.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 la risorsa delle impostazioni di spedizione nella sub-API Accounts:

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

Il seguente elenco riporta gli aggiornamenti principali della risorsa Shipping settings nell'API secondaria Accounts 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 su aree personalizzate, come i gruppi di località. Le aree personalizzate, come i gruppi di località, possono essere lette o scritte solo utilizzando il servizio per le regioni.
3. Un servizio nell'API Merchant supporta più paesi di consegna.
4. A differenza del metodo shippingsettings.list nell'API Content, l'API Merchant non fornisce un metodo list per le impostazioni di spedizione.

Nuovi campi supportati

La risorsa delle impostazioni di spedizione nella sub-API Accounts supporta i seguenti nuovi campi rispetto all'API Content for Shopping:

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

Campi rinominati

I seguenti campi sono stati rinominati nella risorsa Impostazioni di spedizione nella sub-API Accounts:

API Content per Shopping	Risorsa delle impostazioni di spedizione	Descrizione
service	services	Un unico servizio di spedizione.
service.name	services.serviceName	Nome in formato 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 necessari per il transito di un ordine. 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 di transito di un ordine.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Numero minimo di giorni lavorativi necessari prima della spedizione di un ordine.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Numero massimo di giorni lavorativi necessari prima della spedizione di un ordine.
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 di tariffe del corriere.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Un elenco di insiemi di codici negozio che condividono lo stesso valore ordine minimo.

Metodi rimossi

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

Campi rimossi

I seguenti campi dell'API Content for Shopping sono stati rimossi 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
• Rate_group
  • single_value_alternative_list

Metodi

Di seguito è riportato un confronto tra i metodi dell'API Content for Shopping e della risorsa Shipping settings:

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