Migracja ustawień dostawy z Content API for Shopping

Zasób ShippingSettings umożliwia pobieranie i aktualizowanie ustawień dostawy konta oraz wszystkich powiązanych z nim subkont. 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ą interfejsu 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ą interfejsu Merchant API, użyj tych żądań:

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

Więcej informacji znajdziesz w sekcji Metodaaccounts.shippingSettings.insert.

Porównanie Content API for Shopping i Merchant API

Oto przykładowe porównanie 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 zmian w zasobie ustawień dostawy w podrzędnym interfejsie API kont w porównaniu z Content API for Shopping:

  1. Aby uzyskać takie samo działanie, użytkownicy interfejsu Merchant API muszą umieścić wartość accounts/{ACCOUNT_ID}/shippingSettings w polu {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 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 tworzenia listy ustawień dostawy.

Nowe obsługiwane pola

W porównaniu z Content API for Shopping zasób ustawień dostawy w subinterfejsie API Konta obsługuje te nowe pola:

  1. warehouses: zawiera informacje o magazynie realizacji zamówień, w którym przechowywany jest asortyment i z którego jest on wysyłany.
  2. Programy lojalnościowe: użytkownicy Merchant API mogą wprowadzać informacje o programie lojalnościowym do ustawień dostawy.
  3. Etag: Etag ma rozwiązywać problemy asynchroniczne, gdy różni użytkownicy próbują jednocześnie aktualizować ustawienia dostawy za pomocą interfejsu Merchant API i interfejsu Merchant Center.

Pola o zmienionych nazwach

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

Content API for Shopping Zasób ustawień dostawy Opis
service services jedną usługę 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 ma zastosowanie 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 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 operatora.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia.

Usunięte metody

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

Usunięte pola

W Merchant API usunięto te pola z Content API for Shopping. 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 zasobu 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 data sources management
Dalej
Migrate conversion sources management