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

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

Запросы

Чтобы делать запросы, используйте следующий URL-адрес. 

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

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

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

URL-адрес

В Content API для покупок:

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

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

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

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

В Content API для покупок:

{merchantId}/promotions/{promotionId}

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

{name}

Методы

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

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

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

Метод API контента для покупок Торговый API
вставлять Да Да
получать Да Да
список Да Да
customBatch Нет Нет
удалить Нет (Будет определено)

Имя ресурса

В таблице показано, какие изменения касаются рекламных акций в API Merchant Promotions API.

Чтобы увидеть пример для справки, см. раздел «Локальная инвентаризация» .

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

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

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

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

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

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

order_limit (не поддерживается) Атрибут order_limit не поддерживается.
имена служб доставки[] (не поддерживается) 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,
    ]
    }
  ]
}