Перенести управление промоакциями

Вы можете использовать API Merchant Promotions для создания и управления акциями в Google. Ресурс accounts.promotions позволяет демонстрировать специальные предложения на товары, которые вы продаёте в Google. Подробнее см. в разделе «Обзор API Merchant Promotions» .

Обзор изменений от Content API for Shopping к Merchant API

Существенное отличие заключается в том, что Content API for Shopping автоматически создаёт источник данных при первой добавлении промоакции, чего не происходит в Merchant API. Чтобы добавить промоакцию с помощью Merchant API, сначала необходимо создать источник данных о промоакциях . Сведения о полях объекта promotionDataSource в ресурсе accounts.dataSources см. в разделе PromotionDataSource .

Запросы

Для отправки запросов используйте следующий URL.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Миграция из Content API для покупок

Ниже приведено сравнение API контента для покупок с API рекламных акций для запросов, связанных с акциями.

URL

В API контента для покупок:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

в Merchant API становится:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Идентификаторы

В API контента для покупок:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

в Merchant API становится:

{NAME}

Методы

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

  • Вставьте акции
  • Получите повышение
  • Список акций

Ниже приведено сравнение доступности методов продвижения в Content API for Shopping и Merchant API:

Особенность API контента для покупок API торговца
URL https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /promotions https://merchantapi.googleapis.com/promotions/v1/ {parent=accounts/*} /promotions
Идентификаторы {MERCHANT_ID} /promotions/ {PROMOTION_ID} {NAME}
Методы
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Изменения на поле

В таблице показаны изменения для акций в API Merchant Promotions.

Пример для справки можно найти в разделе Локальный инвентарь .

API контента для покупок API торговца Описание
(не поддерживается) пользовательские_атрибуты Список пользовательских атрибутов. Вы можете
также используйте его для отправки любого атрибута фида
спецификация в ее общей форме.
Например:
{
  "name": "size type", "value": "regular"
}
Это полезно для отправки атрибутов, которые явно не указаны.
предоставлено API.
Не поддерживается источник_данных Для создания акции необходим существующий источник данных.
Не поддерживается атрибуты Например, специфические атрибуты продвижения
long_tile , promotion_effective_timeperiod ,
и другие, являются частью атрибутивного сообщения.
item_id включение_идентификатора_элемента Список идентификаторов товаров, на которые распространяется акция
переименован.
store_id включение_идентификатора_магазина Список идентификаторов магазинов, на которые распространяется акция
переименован.
тип_продукта включение_типа_продукта Список типов продукции, на которые распространяется акция
переименован.
item_group_id включение_идентификатора_группы_элементов Список идентификаторов групп товаров, на которые распространяется акция
переименован.
бренд включение_бренда Список брендов, на которые распространяется акция
переименован.
код_магазина включение_кодов_магазина Список кодов магазинов, на которые распространяется акция
переименован. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
Определение цены изменилось.

В API контента для покупок цена
представляло собой десятичное число в виде строки.

Сумма цены теперь указывается в микро,
где 1 миллион микро эквивалентен вашей валюте
стандартная единица.

Имя поля суммы изменилось со значения на
количествоМикрос.

Имя поля валюты изменилось на
Код валюты . Формат остаётся прежним.
ISO 4217. (Википедия)

order_limit (не поддерживается) Атрибут order_limit не поддерживается.
shippingServiceNames[] (не поддерживается) shippingServiceNames[] не поддерживается.
денежный_бюджет (не поддерживается) money_budget не поддерживается.
promotion_destination_ids промо-акции_направления promotionDestinationIds переименован.
Статус продвижения
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Статус акции изменился.
Более подробную информацию можно найти в выпусках. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}