update

Изменяет параметры ключевых фраз и автотаргетингов.

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

Ограничения

Не более 1000 объектов в одном вызове метода.

Запрос

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

{
  "method": "update",
  "params": { /* params */
    "Keywords": [{  /* KeywordUpdateItem */
      "Id": (long), /* required */
      "Keyword": (string), 
      "UserParam1": (string), /* nillable */ 
      "UserParam2": (string) /* nillable */  
    }, ... ] /* required */
  } 
}
ПараметрТипОписаниеОбяза-тельный
Структура params (для JSON) / UpdateRequest (для SOAP)
Keywordsarray of KeywordUpdateItemКлючевые фразы и автотаргетинги, параметры которых требуется изменить.Да
Структура KeywordUpdateItem
IdlongИдентификатор ключевой фразы или автотаргетинга.Да
Keywordstring

Ключевая фраза.

Может содержать минус-слова, которые указывают со знаком минус перед словом, например молния -гром -дождь.

Длина ключевой фразы — не более 4096 символов. Оператор «!» перед минус-словом не учитывается в длине фразы (последовательность «-!» считается как один символ).

Не более 7 слов в ключевой фразе, без учета стоп-слов и минус-слов. Каждое слово — не более 35 символов, без учета минуса перед минус-словом.

Внимание.

Для автотаргетинга значение недоступно для изменения.

Нет
UserParam1string, nillableЗначение подстановочной переменной {param1}. Не более 255 символов.Нет
UserParam2string, nillableЗначение подстановочной переменной {param2}. Не более 255 символов.Нет

Ответ

Структура ответа в формате 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)
UpdateResultsarray of ActionResultРезультаты изменения параметров ключевых фраз и автотаргетингов.
Структура ActionResult
IdlongИдентификатор измененной ключевой фразы или автотаргетинга. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warningsarray of ExceptionNotification

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

Errorsarray of ExceptionNotification

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