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