Migracja ustawień dostawy z Content API for Shopping

Zasób ShippingSettings umożliwia pobieranie i aktualizowanie ustawień dostawy na koncie i wszystkich powiązanych z nim subkontach. Więcej informacji o dodawaniu ustawień dostawy na koncie i zarządzaniu nimi znajdziesz w artykule Omówienie ustawień dostawy.

Aby użyć interfejsu Merchant API do odczytu informacji o ustawieniach dostawy, użyj tych żądań:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings

Zastąp {ACCOUNT_ID} unikalnym identyfikatorem swojego konta Merchant Center.

Aby użyć interfejsu Merchant API do zaktualizowania informacji o ustawieniach dostawy, użyj tych żądań:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

Więcej informacji znajdziesz w artykule Metoda: accounts.shippingSettings.insert.

Porównanie Content API for Shopping i Merchant API

Oto przykładowe porównanie interfejsu Content API for Shopping z zasobem ustawień dostawy w podrzędnym interfejsie API kont:

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

Poniżej znajdziesz listę najważniejszych aktualizacji zasobu Shipping settings w podrzędnym interfejsie API Accounts w porównaniu z Content API for Shopping:

1. Użytkownicy interfejsu Merchant API muszą wpisać accounts/{ACCOUNT_ID}/shippingSettings w polu {NAME}, aby uzyskać takie samo działanie.
2. Interfejs Merchant API nie obsługuje operacji odczytu i zapisu w obszarach niestandardowych, takich jak grupy lokalizacji. Obszary niestandardowe, takie jak grupy lokalizacji, można odczytywać i zapisywać tylko za pomocą usługi regionu.
3. Jedna usługa w Merchant API obsługuje wiele krajów dostawy.
4. Merchant API nie udostępnia metody list dla ustawień dostawy, w przeciwieństwie do metody shippingsettings.list w Content API.

Nowe obsługiwane pola

Zasób ustawień dostawy w podrzędnym interfejsie API Accounts obsługuje te nowe pola w porównaniu z Content API for Shopping:

1. warehouses: zawiera informacje o magazynie, w którym przechowywany i obsługiwany jest asortyment.
2. Programy lojalnościowe: użytkownicy Merchant API mogą wprowadzać informacje o programie lojalnościowym w ustawieniach dostawy.
3. Etag: Etag służy do rozwiązywania problemów z asynchronicznością, gdy różni użytkownicy próbują jednocześnie zaktualizować ustawienia dostawy za pomocą interfejsu Merchant API i interfejsu Merchant Center.

Pola, których nazwy zostały zmienione

W zasobie ustawień dostawy w podrzędnym interfejsie API kont zmieniono nazwy tych pól:

Content API for Shopping	Zasób ustawień dostawy	Opis
service	services	Jedna usługa dostawy.
service.name	services.serviceName	Dowolna nazwa usługi, która musi być unikalna na Twoim koncie Merchant Center.
service.deliveryCountry	services.deliveryCountries	Kod regionu CLDR kraju, do którego odnosi się usługa dostawy.
service.currency	services.currencyCode	Kod CLDR waluty, do której odnosi się ta usługa.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Minimalna liczba dni roboczych, przez które zamówienie jest w drodze. Na przykład 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Maksymalna liczba dni roboczych, przez które zamówienie jest w drodze.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Minimalna liczba dni roboczych przed wysłaniem zamówienia.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Maksymalna liczba dni roboczych przed wysłaniem zamówienia.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identyfikator strefy czasowej dla ostatecznego terminu.
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 stawek dostawy.
service.rate_group.subtable	services.rateGroups.subtables	Lista podtabel.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Lista stawek przewoźnika.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Lista zestawów kodów sklepów, które mają tę samą minimalną wartość zamówienia.

Usunięte metody

Nie możesz używać shippingsettings.custombatch do pobierania i aktualizowania ustawień dostawy wielu kont w jednym żądaniu.

Usunięte pola

Te pola z Content API for Shopping zostały usunięte w Merchant API. Interfejs Merchant API nie udostępnia żadnej alternatywy dla tych pól.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Rate_group
  • single_value_alternative_list

Metody

Oto porównanie metod w Content API for Shopping i zasobie ustawień dostawy:

Metoda	Content API for Shopping	Merchant API
customBatch	Tak	Nie
get	Tak	Tak
update	Tak	Nie
insert	Nie	Tak
list	Tak	Nie
getSupportedCarrier	Tak	Nie
getSupportedHolidays	Tak	Nie