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

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

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

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

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

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

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

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

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

Вот пример сравнения Content API для покупок с ресурсом настроек доставки в подAPI учетных записей:

	API контента	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}

Ниже приведён список основных обновлений ресурса настроек доставки в подсистеме API «Учётные записи» по сравнению с API контента для покупок:

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

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

Ресурс настроек доставки в подсистеме API «Учетные записи» поддерживает следующие новые поля по сравнению с Content API для покупок:

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

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

В ресурсе «Настройки доставки» в подсистеме 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
• Rate_group
  • single_value_alternative_list

Методы

Вот сравнение методов в Content API для покупок и ресурсе настроек доставки:

Метод	API контента для покупок	API для продавцов
customBatch	Да	Нет
get	Да	Да
update	Да	Нет
insert	Нет	Да
list	Да	Нет
getSupportedCarrier	Да	Нет
getSupportedHolidays	Да	Нет