UpdateCampaignsTags (Live)
Формирует список меток для указанной кампании или списки для нескольких кампаний.
Метод используется для добавления, изменения, удаления меток, доступных в рамках кампании. При добавлении меток им автоматически присваиваются уникальные идентификаторы, с помощью которых метки назначают объявлениям (см. UpdateBannersTags).
Входные данные
Метод принимает массив объектов CampaignTagsInfo. Каждый объект содержит метки для одной кампании.
{
"method": "UpdateCampaignsTags",
"param": [
{ /* CampaignTagsInfo */
"CampaignID": (int),
"Tags": [
{ /* TagInfo */
"TagID": (int),
"Tag": (string)
}
...
]
}
...
]
}
Ниже приведено описание параметров.
|
Параметр |
Описание |
Требуется |
|
Объект CampaignTagsInfo |
||
|
|
Идентификатор кампании, для которой формируется список меток. |
Да |
|
|
Массив объектов |
Да |
|
Объект TagInfo |
||
|
|
Идентификатор метки. Для добавления метки задайте 0. Для редактирования метки укажите ее идентификатор. Если метка с указанным идентификатором отсутствует, возвращается сообщение об ошибке. Внимание Метод удаляет метки не указанные при вызове. Для сохранения меток их необходимо явно указать с прежним значением. Текущий список меток получают с помощью метода GetCampaignsTags. |
Да |
|
|
Текстовая метка (не более 25 символов). Текст должен быть уникален в рамках кампании без учета регистра символов (не допускается наличие в кампании меток, тексты которых совпадают или отличаются только регистром). При попытке задать дублирующую метку возвращается ошибка с кодом 71. |
Да |
Результирующие данные
Метод возвращает массив объектов CampaignTagsInfo. Каждый объект содержит метки одной кампании, указанной при вызове.
{
"data": [
{ /* CampaignTagsInfo */
"CampaignID": (int),
"Tags": [
{ /* TagInfo */
"TagID": (int),
"Tag": (string)
}
...
]
}
...
]
}
Ниже приведено описание параметров.
|
Параметр |
Описание |
|
Объект CampaignTagsInfo |
|
|
|
Идентификатор кампании. |
|
|
Массив объектов |
|
Объект TagInfo |
|
|
|
Уникальный идентификатор тега. Новым тегам идентификаторы присваиваются автоматически. |
|
|
Текстовая метка, переданная при вызове метода. |
Примеры входных данных
Python
[
{
'CampaignID': 3193279,
'Tags': [{'TagID': 0, 'Tag': 'akapulko'}, {'TagID': 16590, 'Tag': 'orange'}]
}
]
PHP
array(
array(
'CampaignID' => 3193279,
'Tags' => array(
array('TagID' => 0, 'Tag' => 'akapulko'), array('TagID' => 16590, 'Tag' ='orange')
)
)
)
Perl
[
{
'CampaignID' => 3193279,
'Tags' => [{'TagID' =0, 'Tag' => 'akapulko'}, {'TagID' => 16590, 'Tag' ='orange'}]
}
]