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'}]
   }
]