update

Изменяет наборы минус-фраз.

  1. Ограничения
  2. Запрос
  3. Ответ

Ограничения

Не более 30 наборов минус-фраз в одном вызове метода.

Запрос

Структура запроса в формате JSON:

{
  "method": "update",
  "params": { /* params */
    "NegativeKeywordSharedSets": [{  /* NegativeKeywordSharedSetUpdateItem */
      "Id": (long), /* required */
      "Name": (string),
      "NegativeKeywords": [(string), ... ] 
    }, ... ] /* required */
  }
} 
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / UpdateRequest (для SOAP)
NegativeKeywordSharedSets array of NegativeKeywordSharedSetUpdateItem Наборы минус-фраз, которые требуется изменить. Не более 30 элементов в массиве. Да
Структура NegativeKeywordSharedSetUpdateItem
Id long Идентификатор условия ретаргетинга и подбора аудитории. Да
Name string Название набора минус-фраз (не более 255 символов). Нет
NegativeKeywords array of string

Массив минус-фраз.

Минус-фразу следует указывать без минуса перед первым словом.

Не более 7 слов в минус-фразе. Длина каждого слова — не более 35 символов. Суммарная длина минус-фраз в массиве — не более 4096 символов. Пробелы, дефисы и операторы не учитываются в суммарной длине.

Нет
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / UpdateRequest (для SOAP)
NegativeKeywordSharedSets array of NegativeKeywordSharedSetUpdateItem Наборы минус-фраз, которые требуется изменить. Не более 30 элементов в массиве. Да
Структура NegativeKeywordSharedSetUpdateItem
Id long Идентификатор условия ретаргетинга и подбора аудитории. Да
Name string Название набора минус-фраз (не более 255 символов). Нет
NegativeKeywords array of string

Массив минус-фраз.

Минус-фразу следует указывать без минуса перед первым словом.

Не более 7 слов в минус-фразе. Длина каждого слова — не более 35 символов. Суммарная длина минус-фраз в массиве — не более 4096 символов. Пробелы, дефисы и операторы не учитываются в суммарной длине.

Нет

Ответ

Структура ответа в формате JSON:

{
  "result": {  /* result */
    "UpdateResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ] 
    }, ... ] /* required */
  }
}
Параметр Тип Описание
Структура result (для JSON) / UpdateResponse (для SOAP)
UpdateResults array of ActionResult Результаты изменения наборов минус-фраз.
Структура ActionResult
Id long Идентификатор набора минус-фраз. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.

Параметр Тип Описание
Структура result (для JSON) / UpdateResponse (для SOAP)
UpdateResults array of ActionResult Результаты изменения наборов минус-фраз.
Структура ActionResult
Id long Идентификатор набора минус-фраз. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.