UpdatePrices (Live)
Задает ставки и/или приоритеты для указанных фраз.
Метод отключен. Используйте API версии 5.
Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.
Изменения ставок вступают в силу спустя некоторое время, см. правила показа.
Ограничения
Не более 3000 вызовов метода для одной кампании в сутки. За один вызов можно установить цены не более чем для 1000 фраз.
Новое в версии Live 4
Добавлен входной параметр Currency (см. также раздел Реальные валюты вместо у. е.).
Входные данные
Ниже показана структура входных данных в формате JSON.
{
"method": "UpdatePrices",
"param": [
{ /* PhrasePriceInfo */
"CampaignID": (int),
"PhraseID": (long),
"Price": (float),
"ContextPrice": (float),
"AutoBroker": (string),
"AutoBudgetPriority": (string),
"Currency": (string)
}
...
]
}
Параметр param содержит массив объектов PhrasePriceInfo (не более 1000 объектов), каждый из которых устанавливает цены для одной фразы. Ниже приведено описание параметров.
Параметр | Описание | Требуется |
Объект PhrasePriceInfo | ||
---|---|---|
CampaignID | Идентификатор кампании. | Да |
PhraseID | Идентификатор фразы. | Да |
Price | Ставка на поиске Яндекса (в валюте, указанной в параметре Currency). Используется, только если для кампании выбрана стратегия с ручным управлением ставками. Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. | Хотя бы один из параметров: Price , AutoBudgetPriority , ContextPrice . Значения неуказанных параметров не изменяются. |
ContextPrice | Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре Currency). Параметр доступен для изменения в следующих случаях:
Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. | |
AutoBudgetPriority | Приоритет фразы при использовании автоматических стратегий. Возможные значения:
| |
AutoBroker | Включить/выключить автоброкер. Параметр не используется, переданное значение игнорируется. | Нет |
Currency | Валюта, в которой указаны ставки. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании. Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту (см. раздел Реальные валюты вместо у. е.). Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом 245. | Нет |
Параметр | Описание | Требуется |
Объект PhrasePriceInfo | ||
---|---|---|
CampaignID | Идентификатор кампании. | Да |
PhraseID | Идентификатор фразы. | Да |
Price | Ставка на поиске Яндекса (в валюте, указанной в параметре Currency). Используется, только если для кампании выбрана стратегия с ручным управлением ставками. Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. | Хотя бы один из параметров: Price , AutoBudgetPriority , ContextPrice . Значения неуказанных параметров не изменяются. |
ContextPrice | Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре Currency). Параметр доступен для изменения в следующих случаях:
Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits. Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке. | |
AutoBudgetPriority | Приоритет фразы при использовании автоматических стратегий. Возможные значения:
| |
AutoBroker | Включить/выключить автоброкер. Параметр не используется, переданное значение игнорируется. | Нет |
Currency | Валюта, в которой указаны ставки. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании. Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту (см. раздел Реальные валюты вместо у. е.). Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом 245. | Нет |
Результирующие данные
При успешном выполнении метод возвращает значение 1, как показано в следующем примере.
{
"data": 1
}
Примеры входных данных
Python
[
{
'CampaignID': 3665578,
'PhraseID': 199381759,
'Price': 6.5,
'AutoBudgetPriority': 'Medium',
'ContextPrice': 3.2
}
]
PHP
array(
array(
'CampaignID' => 3665578,
'PhraseID' => 199381759,
'Price' => 6.5,
'AutoBudgetPriority' => 'Medium',
'ContextPrice' => 3.2
)
)
Perl
[
{
'CampaignID' => 3665578,
'PhraseID' => 199381759,
'Price' => 6.5,
'AutoBudgetPriority' => 'Medium',
'ContextPrice' => 3.2
}
]