Migracja ustawień dostawy z Content API for Shopping

ShippingSettings umożliwia pobieranie i aktualizowanie ustawień dostawy na koncie oraz wszystkich powiązanych z nim subkont. Aby dowiedzieć się więcej o tym, jak Dodaj ustawienia dostawy na koncie i zarządzaj nimi, zobacz Omówienie dostawy ustawieniach.

Aby używać interfejsu Merchant API do odczytu informacji o ustawieniach dostawy, użyj tych żądania:

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

Zastąp {accountId} unikalnym identyfikatorem swojego konto Merchant Center.

Aby używać interfejsu Merchant API do odczytu informacji o ustawieniach dostawy, użyj tych żądania:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/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 Content API for Shopping z kontem sprzedawcy Interfejs API ustawień dostawy:

	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}

Poniższa lista zawiera najważniejsze zmiany w interfejsie 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: {name}, aby zachować takie samo działanie.
2. Interfejs Merchant API nie obsługuje operacji odczytu i zapisu na obszarach niestandardowych, takich jak jako grupy lokalizacji. Obszary niestandardowe, takie jak grupy lokalizacji, mogą być tylko do odczytu lub zapisane przy użyciu usługi regionu.
3. Sposób skonfigurowania WarehouseBasedDeliveryTime w interfejsie Merchant API różni się od interfejsu Content API for Shopping. Jeśli używasz interfejsu Merchant API, musisz zdefiniować informacje o magazynie shippingsettings.warehouses Następnie każda usługa dostawy może wykorzystać atrybut hurtownię dzięki nazwie magazynu w domenie warehouseBaseDeliveryTime.
4. Jedna usługa w interfejsie Merchant API obsługuje wiele krajów dostawy.

Nowe obsługiwane pola

Interfejs API ustawień dostawy sprzedawcy obsługuje następujące nowe pola w porównaniu z Content API for Shopping:

1. Magazyny: zawiera informacje o magazynie realizacji. który przechowuje i obsługuje asortyment.
2. Programy lojalnościowe: użytkownicy interfejsu API sprzedawcy mogą wpisywać informacje o programie lojalnościowym w swoje ustawienia dostawy.
3. Etag: narzędzie Etag zostało zaprojektowane do rozwiązywania problemów asynchronicznych, gdy różni użytkownicy zaktualizuj ustawienia dostawy za pomocą interfejsu Merchant Center i interfejsu Merchant Center na jednocześnie.

Zmienione nazwy pól

Nazwy tych pól w interfejsie Merchant API zostały zmienione:

Content API for Shopping	Interfejs API ustawień dostawy sprzedawcy	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 regionu CLDR kraju, do którego odnosi się usługa dostawy.
service.currency	services.currencyCode	Kod CLDR waluty, do której odnosi się dana usługa.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Minimalna liczba dni roboczych, przez które zamówienie jest transportowane. 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 potrzebnych do zrealizowania zamówienia.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Minimalna liczba dni roboczych potrzebnych do wysyłki 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, która określa 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	Lista stawek przewoźnika.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia.

Wycofane metody

Za pomocą shippingsettings.custombatch nie można pobierać i zaktualizować ustawienia dostawy dla wielu kont naraz.

Wycofane pola

Poniższe pola z Content API zostały wycofane z Merchant API. Sprzedawca Interfejs API nie oferuje żadnej alternatywy 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 Interfejs API ustawień dostawy sprzedawcy:

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