Migracja ustawień dostawy z Content API for Shopping

Zasób ShippingSettings umożliwia pobieranie i aktualizowanie ustawień dostawy na Twoim koncie oraz wszystkich powiązanych z nim subkontach. Więcej informacji o tym, jak dodawać ustawienia dostawy na koncie i nimi zarządzać, znajdziesz w artykule Omówienie ustawień dostawy.

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

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

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

Aby zaktualizować ustawienia dostawy za pomocą interfejsu Merchant API, użyj tych żądań:

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

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

Porównanie Content API for Shopping i Merchant API

Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem API ustawień dostawy sprzedawcy:

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

Poniżej znajdziesz listę najważniejszych zmian w interfejsie API ustawień dostawy dla sprzedawców w porównaniu z Content API for Shopping:

1. Aby uzyskać takie samo działanie, użytkownicy interfejsu Merchant API muszą wpisać wartość accounts/{ACCOUNT_ID}/shippingSettings do pola {NAME}.
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 region.
3. Sposób konfigurowania WarehouseBasedDeliveryTime różni się w przypadku interfejsu Merchant API w porównaniu z interfejsem Content API for Shopping. Jeśli używasz interfejsu Merchant API, musisz zdefiniować informacje o magazynie w sekcji shippingsettings.warehouses. Następnie każda usługa dostawy może odwoływać się do magazynu za pomocą nazwy magazynu w sekcji warehouseBaseDeliveryTime.
4. Jedna usługa w Merchant API obsługuje wiele krajów dostawy.

Nowe obsługiwane pola

W porównaniu z Content API for Shopping interfejs API ustawień dostawy sprzedawcy obsługuje te nowe pola:

1. Magazyny: zawierają informacje o magazynie logistycznym, w którym przechowywane są produkty i który zarządza nimi.
2. Programy lojalnościowe: użytkownicy Merchant API mogą wprowadzać informacje o programie lojalnościowym w ustawieniach dostawy.
3. Etag: Etag ma na celu rozwiązywanie problemów z asynchronicznością, gdy różni użytkownicy próbują w tym samym czasie aktualizować ustawienia dostawy za pomocą interfejsu Merchant API i Merchant Center.

Zmienione nazwy pól

W interfejsie Merchant API zmieniliśmy nazwy tych pól:

Content API for Shopping	Interfejs API ustawień dostawy sprzedawcy	Opis
service	services	jedna usługa dostawy,
service.name	services.serviceName	Wolnoformowa nazwa usługi, która musi być unikalna na Twoim koncie Merchant Center.
service.deliveryCountry	services.deliveryCountries	Kod regionu CLDR kraju, w którym obowiązuje usługa dostawy.
service.currency	services.currencyCode	Kod CLDR waluty, której dotyczy ta usługa.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Minimalna liczba dni roboczych, przez które zamówienie jest w transporcie. 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 czasu granicznej wartości.
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 podtablic.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Lista stawek operatora.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia.

Wycofane metody

Nie możesz użyć wywołania shippingsettings.custombatch do pobrania i zaktualizowania ustawień dostawy na wielu kontach w ramach jednej prośby.

Wycofane pola

Te pola z Content API zostały wycofane w Merchant API: Merchant API nie udostępnia żadnych alternatyw dla tych pól.

• 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

Metody

Oto porównanie metod w Content API for Shopping i interfejsie Merchant Shipping Settings API:

Metoda	Content API for Shopping	Interfejs API sprzedawcy
customBatch	Tak	Nie
get	Tak	Tak
update	Tak	Nie
insert	Nie	Tak
getSupportedCarrier	Tak	Nie
getSupportedHolidays	Tak	Nie