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 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, vedi Metodo: accounts.shippingSettings.insert.

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

Ecco un confronto di esempio tra l'API Content for Shopping e la risorsa Impostazioni 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 menziona gli aggiornamenti principali nella risorsa Impostazioni di spedizione nella sotto-API Accounts rispetto all'API Content for Shopping:

  1. Gli utenti dell'API Merchant devono inserire accounts/{ACCOUNT_ID}/shippingSettings nel campo {NAME} per avere lo stesso comportamento.
  2. L'API Merchant non supporta le operazioni di lettura e scrittura su aree personalizzate, ad esempio i gruppi di sedi. Le aree personalizzate come i gruppi di località possono essere lette o scritte solo utilizzando il servizio di regioni.
  3. Un servizio nell'API Merchant supporta più paesi di consegna.
  4. L'API Merchant non fornisce un metodo di elenco per le impostazioni di spedizione, a differenza del metodo shippingsettings.list nell'API Content.

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, che archivia e gestisce l'inventario.
  2. Programmi fedeltà: gli utenti dell'API Merchant possono inserire le informazioni del programma fedeltà nelle impostazioni di spedizione.
  3. Etag: Etag è progettato per risolvere i problemi asincroni quando diversi utenti 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 Impostazioni di spedizione Descrizione
service services Un unico servizio di spedizione.
service.name services.serviceName Nome in formato libero del servizio che deve essere unico 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 durante i quali un ordine è in transito. 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 tabelle secondarie.
service.rate_group.carrier_rate services.rateGroups.carrierRates Un elenco delle 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 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 vengono 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 Impostazioni di spedizione:

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
Indietro
Migrate data sources management
Avanti
Migrate conversion sources management