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:
- Gli utenti dell'API Merchant devono inserire
accounts/{accountId}/shippingSettings
nel {name} per avere lo stesso comportamento. - 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.
- 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 inshippingsettings.warehouses
. Ogni servizio di spedizione può quindi fare riferimento dal magazzino tramite il nome del magazzino sottowarehouseBaseDeliveryTime
. - 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:
- Warehouse: fornisce informazioni su un magazzino per l'evasione degli ordini, che archivia e gestisce l'inventario.
- Programmi fedeltà: gli utenti dell'API Merchant possono inserire informazioni sul programma fedeltà per le relative impostazioni di spedizione.
- 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 |