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

С помощью Merchant Promotions API можно создавать специальные предложения в Google и управлять ими. Ресурс accounts.promotions позволяет показывать специальные предложения для товаров, которые вы продаете в Google. Подробнее о Специальных предложениях Merchant API…

Обзор изменений при переходе с Content API for Shopping на Merchant API

Важное отличие заключается в том, что Content API for Shopping автоматически создает источник данных при первом добавлении промоакции, а Merchant API – нет. Чтобы добавить промоакцию с помощью Merchant API, сначала нужно создать источник данных для промоакций.

Информацию о полях объекта promotionDataSource в ресурсе accounts.dataSources можно найти в статье PromotionDataSource.

Существующие источники данных

Если вы не знаете accounts.dataSources.name существующего источника данных, используйте dataSources.list, чтобы получить его.

Вы также можете определить источник данных для каждой из своих промоакций, используя метод accounts.promotions.get и проверяя поле dataSource в ответе для любой существующей промоакции в вашем аккаунте.

Чтобы ссылаться на них напрямую в будущих вызовах API, настоятельно рекомендуем хранить accounts.dataSources.name в локальной базе данных для каждой промоакции.

Запросы

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

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

Переход с Content API for Shopping

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

URL

В Content API for Shopping:

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

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

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

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

В Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

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

{NAME}

Методы

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

• Добавление промоакций
• Получать информацию о промоакциях
• Список промоакций

Ниже приведено сравнение доступности методов промоакций в Content API for Shopping и Merchant API.

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

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

Пример можно посмотреть в статье accounts.promotions.

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

{
  "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,
    ]
    }
  ]
}