Migracja ustawień dostawy z Content API for Shopping

Zasób ShippingSettings umożliwia pobieranie i aktualizowanie ustawień dostawy na koncie oraz na 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ć informacje o ustawieniach dostawy za pomocą Merchant API, użyj tych żądań:

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

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

Aby zaktualizować informacje o ustawieniach dostawy za pomocą Merchant API, 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 Content API for Shopping z zasobem Ustawienia 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ższa lista zawiera główne zmiany w zasobie Ustawienia dostawy w podrzędnym interfejsie API kont w porównaniu z Content API for Shopping:

  1. Aby uzyskać to samo działanie, użytkownicy Merchant API muszą umieścić accounts/{ACCOUNT_ID}/shippingSettings w polu {NAME}.
  2. 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. W przeciwieństwie do metody shippingsettings.list w Content API, Merchant API nie udostępnia metody list dla ustawień dostawy.

Nowe obsługiwane pola

W porównaniu z Content API for Shopping zasób Ustawienia dostawy w podrzędnym interfejsie API kont obsługuje te nowe pola:

  1. warehouses: zawiera informacje o magazynie realizacji zamówień, w którym przechowywane są produkty i obsługiwany jest asortyment.
  2. Programy lojalnościowe: użytkownicy Merchant API mogą wprowadzać informacje o programach lojalnościowych w ustawieniach dostawy.
  3. Etag: Etag ma na celu rozwiązanie problemów asynchronicznych, gdy różni użytkownicy próbują jednocześnie aktualizować ustawienia dostawy za pomocą Merchant API i interfejsu Merchant Center.

Pola, których nazwy zostały zmienione

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

Content API for Shopping Zasób Ustawienia dostawy Opis
service services Pojedyncza usługa dostawy.
service.name services.serviceName Dowolna nazwa usługi, która musi być unikalna na 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 transporcie. 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 w transporcie.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Minimalna liczba dni roboczych, które upływają przed wysłaniem zamówienia.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Maksymalna liczba dni roboczych, które upływają 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 sklepu, 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 na wielu kontach w jednym żądaniu.

Usunięte pola

Te pola z Content API for Shopping zostały usunięte w Merchant API. 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 Ustawienia 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
Wstecz
Migrate region management
Dalej
Migrate online return policy management