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 символов. | Нет |
Параметр | Тип | Описание | Обяза-тельный |
Структура 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 | Ошибки, возникшие при выполнении операции. |