Перенос настроек доставки из 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

Ниже приведен пример сравнения 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. Пользователи API торговца должны ввести accounts/ {ACCOUNT_ID} /shippingSettings в поле {NAME} , чтобы добиться того же поведения.
  2. API продавца не поддерживает операции чтения и записи в настраиваемых областях, таких как группы местоположений. Настраиваемые области, такие как группы местоположений, можно читать и записывать только с помощью службы регионов.
  3. Один сервис в Merchant API поддерживает несколько стран доставки.
  4. API продавца не предоставляет метод списка для настроек доставки, в отличие от метода shippingsettings.list в API контента.

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

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

  1. warehouses : Предоставляет информацию о складе, на котором хранятся и обрабатываются запасы.
  2. Программы лояльности : пользователи API торговцев могут вводить информацию о программах лояльности в свои настройки доставки.
  3. Etag : Etag предназначен для решения проблем асинхронности, когда разные пользователи пытаются одновременно обновить настройки доставки с помощью API Merchant и пользовательского интерфейса 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 for Shopping удалены из 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 Да Нет
Назад
Migrate data sources management
Далее
Migrate conversion sources management