Resume
Возобновляет показы по ключевым фразам. Фразы могут относиться к разным кампаниям или группам объявлений.
Внимание.
Метод отключен. Используйте API версии 5.
Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.
Ограничения
Внимание. Метод поддерживает только кампании с типом «Текстово-графические объявления». Для управления фразами в кампаниях всех типов используйте сервис Keywords API версии 5.
Входные данные
Ниже показана структура входных данных в формате JSON.
{
"method": "Keyword",
"param": {
/* KeywordRequest */
"Action": (string),
"Login": (string),
"KeywordIDS": [
(long)
...
]
}
}
Ниже приведено описание параметров.
Параметр | Описание | Требуется |
Объект KeywordRequest | ||
---|---|---|
Action | Выполняемая операция: Resume. | Да |
Login | Логин клиента, для которого нужно выполнить операцию. Прямой рекламодатель может опционально указать логин своего главного представителя. | Для агентств |
KeywordIDS | Массив идентификаторов фраз (не более 10 000). | Да |
Параметр | Описание | Требуется |
Объект KeywordRequest | ||
---|---|---|
Action | Выполняемая операция: Resume. | Да |
Login | Логин клиента, для которого нужно выполнить операцию. Прямой рекламодатель может опционально указать логин своего главного представителя. | Для агентств |
KeywordIDS | Массив идентификаторов фраз (не более 10 000). | Да |
Результирующие данные
Примечание. Ошибки, возникшие при запуске отдельных фраз (54 — в случае отсутствия у пользователя прав на редактирование фразы, 194, 195), не влекут отмену всей операции и не влияют на успешность запуска или остановки остальных фраз.
Ниже показана структура результирующих данных в формате JSON.
{
"data": {
/* KeywordResponse */
"ActionsResult": [
{ /* KeywordActionResult */
"Warnings": [
{ /* Warning */
"WarningCode": (int),
"WarningString": (string),
"Description": (string)
}
...
],
"Errors": [
{ /* Error */
"FaultCode": (int),
"FaultString": (string),
"FaultDetail": (string)
}
...
],
"KeywordID": (long)
}
...
]
}
}
Ниже приведено описание параметров.
Параметр | Описание |
Объект KeywordResponse | |
---|---|
ActionsResult | Массив объектов KeywordActionResult. Каждый объект соответствует элементу входного массива KeywordIDS и содержит:
|
Объект KeywordActionResult | |
Warnings | Массив объектов Warning — предупреждений, возникших при выполнении операции. |
Errors | Массив объектов Error — ошибок, возникших при выполнении операции. |
KeywordID | Идентификатор ключевой фразы. |
Объект Warning | |
WarningCode | Код предупреждения: 212 или 213. |
WarningString | Текст предупреждения. |
Description | Содержит пустую структуру. |
Объект Error | |
FaultCode | Код ошибки. |
FaultString | Текст сообщения об ошибке. |
FaultDetail | Подробное описание причины ошибки. |
Параметр | Описание |
Объект KeywordResponse | |
---|---|
ActionsResult | Массив объектов KeywordActionResult. Каждый объект соответствует элементу входного массива KeywordIDS и содержит:
|
Объект KeywordActionResult | |
Warnings | Массив объектов Warning — предупреждений, возникших при выполнении операции. |
Errors | Массив объектов Error — ошибок, возникших при выполнении операции. |
KeywordID | Идентификатор ключевой фразы. |
Объект Warning | |
WarningCode | Код предупреждения: 212 или 213. |
WarningString | Текст предупреждения. |
Description | Содержит пустую структуру. |
Объект Error | |
FaultCode | Код ошибки. |
FaultString | Текст сообщения об ошибке. |
FaultDetail | Подробное описание причины ошибки. |
Примеры входных данных
Python
{
'Action': 'Resume',
'Login': 'agrom',
'KeywordIDS': [199381759,199482870,200725193]
}
PHP
array(
'Action' => 'Resume',
'Login' => 'agrom',
'KeywordIDS' => array(199381759,199482870,200725193)
)
Perl
{
'Action' => 'Resume',
'Login' => 'agrom',
'KeywordIDS' => [199381759,199482870,200725193]
}