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

La ShippingSettings risorsa consente di recuperare e aggiornare le impostazioni di spedizione dell'account e su tutti i subaccount associati. Per ulteriori informazioni su come puoi Aggiungi o gestisci le impostazioni di spedizione del tuo account; consulta la Panoramica della spedizione impostazioni.

Per utilizzare l'API Merchant per leggere le informazioni delle impostazioni di spedizione, utilizza quanto segue 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 per leggere le informazioni delle impostazioni di spedizione, utilizza quanto segue richieste:

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

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

Confronto tra API Content for Shopping e API Merchant

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

	API Content	API Merchant
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 {name} per avere lo stesso comportamento.
2. L'API Merchant non supporta le operazioni di lettura e scrittura nelle aree personalizzate, come come gruppi di località. Le aree personalizzate, come i gruppi di località, possono essere scritte usando il servizio per regione.
3. Come configurare WarehouseBasedDeliveryTime è diverso per l'API Merchant rispetto all'API Content for Shopping. Se utilizza l'API Merchant, devi definire le informazioni sul magazzino in shippingsettings.warehouses. Ogni servizio di spedizione può quindi fare riferimento dal magazzino tramite il nome del magazzino sotto 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 a API Content for Shopping:

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

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 in formato libero del servizio, che deve essere univoco all'interno del tuo account Merchant Center.
service.deliveryCountry	services.deliveryCountries	Il codice 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 di permanenza di un ordine 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 di permanenza di un ordine 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'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 insiemi 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 un'unica richiesta.

Campi deprecati

I seguenti campi dell'API Content sono stati ritirati nell'API Merchant. Commerciante L'API 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

Ecco un confronto tra i metodi dell'API Content for Shopping e i 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