add

Создает расширения.

В настоящее время доступен один тип расширения — уточнение.

Узнайте больше

Ограничения

Ограничение на количество уточнений для рекламодателя можно получить с помощью метода Clients.get или AgencyClients.get (элемент AD_EXTENSIONS_TOTAL массива Restrictions).

Не более 1000 расширений в одном вызове метода.

Если несколько расширений идентичны, возвращается ошибка для каждого из них.

Запрос

Структура запроса в формате JSON:

{
  "method": "add",
  "params": { /* params */
    "AdExtensions": [{  /* AdExtensionAddItem */
      "Callout": {  /* Callout */
        "CalloutText": (string) /* required */
      }
    }, ... ] /* required */
  }
}

Параметр	Тип	Описание	Обязательный
Структура params (для JSON) / AddRequest (для SOAP)
`AdExtensions`	array of AdExtensionAddItem	Расширения, которые требуется добавить.	Да
Структура AdExtensionAddItem
`Callout`	Callout	Уточнение.	Нет
Структура Callout
`CalloutText`	string	Текст уточнения. Не более 25 символов.	Нет

Ответ

Структура ответа в формате JSON:

{
  "result": { /* result */
    "AddResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}

Параметр	Тип	Описание
Структура result (для JSON) / AddResponse (для SOAP)
`AddResults`	array of ActionResult	Результаты добавления расширений.
Структура ActionResult
`Id`	long	Идентификатор созданного расширения. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
`Warnings`	array of ExceptionNotification	Предупреждения, возникшие при выполнении операции.
`Errors`	array of ExceptionNotification	Ошибки, возникшие при выполнении операции.

Была ли статья полезна?

AdExtensions: операции с расширениями объявлений

delete