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

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

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

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

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

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

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

Дополнительные сведения см. в разделе Метод: accounts.shippingSettings.insert .

Сравнение Content API для покупок и Merchant API

Ниже приведен пример сравнения API контента для покупок с API настроек торговой доставки:

	API контента	Торговый API
URL-адрес	https://shoppingcontent.googleapis.com/content/v2.1/ {ACCOUNT_ID} /shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/ {ACCOUNT_ID} /shippingSettings:insert
Идентификаторы	{ACCOUNT_ID} /shippingsettings/ {ACCOUNT_ID}	{NAME}

В следующем списке перечислены основные обновления API настроек Merchant Shipping по сравнению с Content API для покупок:

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

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

API настроек торговой доставки поддерживает следующие новые поля по сравнению с Content API для покупок:

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

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

Следующие поля были переименованы в Merchant API:

API контента для покупок	API настроек торговой доставки	Описание
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 для получения и обновления настроек доставки нескольких учетных записей в одном запросе.

Устаревшие поля

Следующие поля из Content API устарели в Merchant API. Merchant API не предоставляет альтернативы этим полям.

• 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

Методы

Ниже приведено сравнение методов Content API для покупок и API настроек торговой доставки:

Метод	API контента для покупок	Торговый API
customBatch	Да	Нет
get	Да	Да
update	Да	Нет
insert	Нет	Да
getSupportedCarrier	Да	Нет
getSupportedHolidays	Да	Нет