Migracja ustawień dostawy z Content API for Shopping

Aby odczytać informacje o ustawieniach dostawy za pomocą interfejsu Merchant API, użyj tych żądań:

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

Zastąp {accountId} unikalnym identyfikatorem konta Merchant Center.

Aby odczytać informacje o ustawieniach dostawy za pomocą interfejsu Merchant API, użyj tych żądań:

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

Porównanie Content API for Shopping i Merchant API

Oto przykładowe porównanie Content API for Shopping z interfejsem Merchant Shipping Settings API:

	Content API.	Interfejs API sprzedawcy
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Identyfikatory	{accountId}/shippingsettings/{accountId}	{name}

Na tej liście znajdziesz najważniejsze aktualizacje interfejsu Merchant Shipping settings API w porównaniu z Content API for Shopping:

1. Użytkownicy interfejsu API sprzedawcy muszą umieścić accounts/{accountId}/shippingSettings w polu {name}, aby zapewnić takie samo działanie.
2. Interfejs Merchant API nie obsługuje operacji odczytu i zapisu na obszarach niestandardowych, takich jak grupy lokalizacji. Obszary niestandardowe, takie jak grupy lokalizacji, można odczytywać lub zapisywać tylko przy użyciu usługi regionu.
3. W przypadku interfejsu Merchant API sposób konfiguracji WarehouseBasedDeliveryTime jest inny niż w przypadku Content API for Shopping. Jeśli korzystasz z Merchant API, informacje o magazynie musisz zdefiniować w polu shippingsettings.warehouses. Następnie każda usługa dostawy może odwoływać się do hurtowni za pomocą nazwy magazynu w warehouseBaseDeliveryTime.
4. Jedna usługa w interfejsie API Merchant Center obsługuje wiele krajów dostawy.

Nowe obsługiwane pola

W porównaniu z interfejsem Content API for Shopping interfejs Merchant Shipping Settings API obsługuje te nowe pola:

1. Hurtownie: zawiera informacje o hurtowni realizacji zamówień, która przechowuje i obsługuje asortyment.
2. Programy lojalnościowe: użytkownicy interfejsu API sprzedawcy mogą podawać informacje o programie lojalnościowym w ustawieniach dostawy.
3. Etag: Etag ma na celu rozwiązywanie problemów asynchronicznych, gdy różni użytkownicy próbują aktualizować ustawienia dostawy za pomocą interfejsu Merchant API oraz Merchant Center jednocześnie.

Zmienione nazwy pól

Zmieniliśmy nazwy tych pól w interfejsie Merchant API:

Content API for Shopping	Interfejs API ustawień dostawy dla sprzedawców	Opis
service	services	Jedna usługa dostawy.
service.name	services.serviceName	Swobodna nazwa usługi, która musi być unikalna w obrębie konta Merchant Center.
service.deliveryCountry	services.deliveryCountries	Kod terytorium CLDR kraju, którego dotyczy usługa dostawy.
service.currency	services.currencyCode	Kod CLDR waluty, do której ma zastosowanie ta usługa.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Minimalna liczba dni roboczych, które są wysyłane przez zamówienie. Na przykład 0 oznacza dostawę tego samego dnia, a 1 – dostawę następnego dnia.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Maksymalna liczba dni roboczych, przez które zamówienie jest transportowane.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Minimalna liczba dni roboczych potrzebnych do wysłania zamówienia.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Maksymalna liczba dni roboczych potrzebnych do wysłania zamówienia.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identyfikator strefy czasowej, w której możliwy jest ostateczny termin.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	Nazwa grupy kodów pocztowych.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	Etykieta czasu przewozu produktu.
service.rate_group	services.rateGroups	Definicje grup kosztów dostawy.
service.rate_group.subtable	services.rateGroups.subtables	Lista podtabel.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Listę stawek przewoźnika.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Lista zestawów kodów sklepu o tej samej minimalnej wartości zamówienia.

Wycofane metody

Nie możesz używać usługi shippingsettings.custombatch do pobierania i aktualizowania ustawień dostawy z wielu kont w ramach jednej prośby.

Wycofane pola

Poniższe pola zostały wycofane z interfejsu Merchant API. Pamiętaj, że interfejs Merchant API nie zawiera żadnej alternatywy dla tych pól.

Content API for Shopping	Interfejs API sprzedawcy
postal_code_group	region
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 |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 Metody Oto porównanie metod dostępnych w interfejsie Content API for Shopping i interfejsie Merchant Shipping Settings API: Metoda Content API for Shopping Interfejs API sprzedawcy customBatch Tak Nie get Tak Tak zaktualizowanie Tak Nie Insert Nie Tak getSupportedCarrier Tak Nie getSupportedHolidays Tak Nie