add

Создает креативы для видеодополнений по id видео, полученным в сервисе AdVideos.

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

Ограничения

Не более 10 видео в одном вызове метода.

Запрос

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

{
  "method": "add",
  "params" : { /* required */
    "Creatives" : [{ /* required */
      "VideoExtensionCreative" : { /* required */
        "VideoId" : (string) /* required */
        }
    }, ... ]
  }
}

Параметр

Тип

Описание

Обязательный

Структура params (для JSON) / AddRequest (для SOAP)

Creatives

array of CreativeAddItem

Креативы, которые требуется добавить (не более 10).

Да

Структура CreativeAddItem

VideoExtensionCreative

array of VideoExtensionCreativeAddItem

Настройки креатива для видеодополнений.

Да

Структура VideoExtensionCreativeAddItem

VideoId

string

Идентификационный номер видео.

Да

Ответ

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

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

Параметр

Тип

Описание

Структура result (для JSON) / AddResponse (для SOAP)

AddResults

array

Результаты добавления креативов.

Структура AddResults

Warnings

array of ExceptionNotification

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

Errors

array of ExceptionNotification

Массив ошибок, возникших при постановке видео в очередь на загрузку.

Id

long

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

Структура Warnings, Errors

Code

int

Код ошибки.

Message

string

Текст сообщения об ошибке.

Details

string

Подробное описание причины ошибки.

Следующая