Как перенести настройки доставки из Content API for Shopping

Ресурс ShippingSettings позволяет получать и обновлять настройки доставки в вашем аккаунте и всех связанных с ним дочерних аккаунтах. Подробнее о том, как добавить или изменить настройки доставки в аккаунте…

Чтобы получить информацию о настройках доставки через Merchant API, используйте следующие запросы:

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

Замените {ACCOUNT_ID} уникальным идентификатором своего аккаунта Merchant Center.

Чтобы обновить настройки доставки через Merchant API, используйте следующие запросы:

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

Дополнительную информацию можно найти в статье Метод: accounts.shippingSettings.insert.

Сравнение Content API for Shopping и Merchant API

Ниже приведено сравнение Content API for Shopping с ресурсом настроек доставки в Accounts sub-API.

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
Идентификаторы {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

Ниже перечислены основные изменения в ресурсе Shipping settings в Accounts sub-API по сравнению с Content API for Shopping.

  1. Чтобы получить тот же результат, пользователям Merchant API нужно указать accounts/{ACCOUNT_ID}/shippingSettings в поле {NAME}.
  2. Merchant API не поддерживает операции чтения и записи для пользовательских областей, таких как группы адресов. Специальные области, такие как группы адресов, можно читать и записывать только с помощью сервиса регионов.
  3. Одна служба в Merchant API поддерживает несколько стран доставки.
  4. В Merchant API нет метода list для настроек доставки, в отличие от метода shippingsettings.list в Content API.

Новые поддерживаемые поля

Ресурс настроек доставки в дополнительном API Accounts поддерживает следующие новые поля по сравнению с Content API for Shopping:

  1. warehouses – информация о складе, на котором хранятся и обрабатываются товары.
  2. Программы лояльности. Пользователи Merchant API могут добавлять информацию о программах лояльности в настройки доставки.
  3. Etag. Etag позволяет решать проблемы с асинхронностью, когда разные пользователи пытаются одновременно обновить настройки доставки в Merchant API и интерфейсе Merchant Center.

Переименованные поля

В ресурсе Shipping settings в Accounts sub-API переименованы следующие поля:

Content API for Shopping Ресурс настроек доставки Описание
service services Одна служба доставки.
service.name services.serviceName Название службы доставки, которое должно быть уникальным в пределах вашего аккаунта Merchant Center.
service.deliveryCountry services.deliveryCountries Код CLDR территории, на которой действует служба доставки.
service.currency services.currencyCode Код CLDR валюты, к которой применяется эта служба.
service.deliveryTime.minTransitTimeInDays services.deliveryTime.minTransitDays Минимальное количество рабочих дней, которое заказ проводит в пути. Например, 0 означает доставку в день заказа, а 1 – на следующий день.
service.deliveryTime.maxTransitTimeInDays services.deliveryTime.maxTransitDays Максимальное количество рабочих дней, которое заказ проводит в пути.
service.deliveryTime.minHandlingTimeInDays services.deliveryTime.minHandlingDays Минимальное количество рабочих дней, которое требуется для отправки заказа.
service.deliveryTime.maxHandlingTimeInDays services.deliveryTime.maxHandlingDays Максимальное количество рабочих дней, которое требуется для обработки заказа перед отправкой.
service.deliveryTime.cutoffTime.timezone services.deliveryTime.cutoffTime.timeZone Идентификатор часового пояса для времени заказа для обработки в тот же день.
service.deliveryTime.transitTimeTable.postalCodeGroupName services.deliveryTime.transitTimeTable.postalCodeGroupNames Название группы почтовых индексов.
service.deliveryTime.transitTimeTable.transitTimeLabel services.deliveryTime.transitTimeTable.transitTimeLabel Ярлык времени транспортировки товара.
service.rate_group services.rateGroups Определения групп тарифов доставки.
service.rate_group.subtable services.rateGroups.subtables Список подтаблиц.
service.rate_group.carrier_rate services.rateGroups.carrierRates Список тарифов транспортных компаний.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Список наборов кодов магазинов с одинаковой минимальной стоимостью заказа.

Удаленные способы

Вы не можете использовать shippingsettings.custombatch, чтобы получить и обновить настройки доставки нескольких аккаунтов в одном запросе.

Удаленные поля

В Merchant API удалены следующие поля из Content API for Shopping: В Merchant API нет альтернативных полей.

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

    • Rate_group
      • single_value_alternative_list

Методы

Ниже приведено сравнение методов в Content API for Shopping и ресурсе Shipping settings.

Метод Content API for Shopping Merchant API
customBatch Да Нет
get Да Да
update Да Нет
insert Нет Да
list Да Нет
getSupportedCarrier Да Нет
getSupportedHolidays Да Нет
Назад
Migrate region management
Далее
Migrate online return policy management