add

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

  1. Ограничения
  2. Запрос
  3. Ответ

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

Ограничения

Ограничение на количество уточнений для рекламодателя можно получить с помощью метода 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 символов. Нет
Параметр Тип Описание Обяза-тельный
Структура 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

Ошибки, возникшие при выполнении операции.

Параметр Тип Описание
Структура result (для JSON) / AddResponse (для SOAP)
AddResults array of ActionResult Результаты добавления расширений.
Структура ActionResult
Id long

Идентификатор созданного расширения. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.

Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.