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. Каждый объект содержит метки одной кампании, указанной при вызове.

{
   "data": [
      {  /* CampaignTagsInfo */
         "CampaignID": (int),
         "Tags": [
            {  /* TagInfo */
               "TagID": (int),
               "Tag": (string)
            }
            ...
         ]
      }
      ...
   ]
}

Ниже приведено описание параметров.

Параметр Описание
Объект 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'}]
   }
]