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

Вы можете использовать API для создания и управления рекламными акциями в Google. Ресурс accounts.promotions позволяет демонстрировать специальные предложения для товаров, которые вы продаете в Google. Для получения дополнительной информации см. Обзор API для рекламных акций .

Обзор изменений от Content API для покупок к Merchant API

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

Запросы

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

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

Переход с Content API для покупок

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

URL

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

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

В API для продавцов это выглядит так:

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

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

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

{MERCHANT_ID}/promotions/{PROMOTION_ID}

В API для продавцов это выглядит так:

{NAME}

Методы

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

  • Вставить рекламные предложения
  • Получайте акции
  • Список рекламных акций

Вот сравнение доступных методов продвижения в Content API для покупок и 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 для торговых акций.

В качестве примера см. раздел «Локальный инвентарь» .

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

price:
  {
    object (Price)
  }
Определение понятия «цена» изменилось.

В Content API для покупок, Цена
Это было десятичное число в виде строки.

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

Название поля «сумма» изменилось с «значение» на
amountMicros.

Название поля валюты изменилось на
currencyCode . Формат остается прежним.
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,
    ]
    }
  ]
}