КомпанияБлогВакансииРазработчикамРекламодателям
СобытияНаукаОбучение
API Директа
Документация
API версии 5. История изменений
API версии 5. Руководство разработчика
Обзор API Директа версии 5
Варианты использования
Начните разрабатывать свое приложение
Основные объекты
Кампания (Campaign)
Стратегии показа
Параметры кампаний
Группа объявлений (AdGroup)
Объявление (Ad)
Набор быстрых ссылок (SitelinksSet)
Визитка (VCard)
Изображение (AdImage)
Расширение (AdExtension)
Ключевая фраза (Keyword)
Ставка и приоритет (Bid)
Корректировка ставок (BidModifier)
Условие нацеливания на аудиторию (AudienceTarget)
Условие подбора аудитории (RetargetingList)
Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage)
Клиент (Client)
Общий счет (SharedAccount)
Доступ и авторизация
Регистрация приложения
Авторизационные токены
Роли и доступы пользователей Директа
Формат взаимодействия
HTTP-заголовки
JSON
SOAP
Обработка ошибок
Ограничения
Общие свойства методов API версии 5
Получение данных
Операции над массивом объектов
Редактирование отдельных параметров
Значение null (nil)
Практика использования
Ведение рекламной кампании
Минус-фразы
Автотаргетинг
Отслеживание изменений
Статистика и аналитика
Динамические объявления
Представители
Агентствам
Песочница
Управление Песочницей
Список терминов
API версии 5. Справочник
AdExtensions: операции с расширениями объявлений
add
delete
get
AdGroups: операции с группами объявлений
add
delete
get
update
AdImages: операции с изображениями
add
delete
get
Ads: операции с объявлениями
add
archive
delete
get
moderate
resume
suspend
unarchive
update
AgencyClients: управление клиентами агентства
add
get
update
AudienceTargets: управление условиями нацеливания на аудиторию
add
delete
get
resume
setBids
suspend
Bids: управление ставками
get
set
setAuto
BidModifiers: управление корректировками ставок
add
delete
get
set
toggle
Campaigns: управление кампаниями
add
TextCampaign
DynamicTextCampaign
MobileAppCampaign
archive
delete
get
TextCampaign
DynamicTextCampaign
MobileAppCampaign
resume
suspend
unarchive
update
TextCampaign
DynamicTextCampaign
MobileAppCampaign
Changes: проверка наличия изменений
checkDictionaries
checkCampaigns
check
Clients: управление параметрами рекламодателя и настройками пользователя
get
update
Dictionaries: получение справочных данных
get
DynamicTextAdTargets: управление условиями нацеливания для динамических объявлений
add
delete
get
resume
setBids
suspend
KeywordBids: управление ставками (beta)
get (beta)
set (beta)
Keywords: управление ключевыми фразами и автотаргетингами
add
delete
get
resume
suspend
update
KeywordsResearch: получение прогноза наличия показов
hasSearchVolume
Leads: получение данных из форм на турбо-страницах
get
RetargetingLists: управление условиями подбора аудитории
add
delete
get
update
Sitelinks: операции с быстрыми ссылками
add
delete
get
VCards: операции с визитками
add
delete
get
Ошибки и предупреждения
Справочные данные
Типы стратегий
Настройки кампаний (параметр Option)
API версии 5. Статистика
Как сформировать отчет
Период отчета
Тип отчета
Поля отчета
Денежные значения
Фильтрация данных
HTTP-заголовки
Запрос: спецификация отчета
Допустимые поля
Несовместимые поля и зависимости
Формат отчета и описание полей
Онлайн- и офлайн-отчет
Актуальность статистики
Коды ответов и ошибки
Ограничения
Пример
API версии 5. Примеры
cURL
Настройка временного таргетинга
Изменение стратегии
Добавление метки в ссылку объявлений
Остановка и запуск объявлений
Назначение ставок
PHP
Получение токена
JSON (file_get_contents)
Получение кампаний
Создание объявлений
Обработка нехватки баллов
JSON (cURL)
Получение кампаний
Создание объявлений
Получение статистики за произвольные даты
Получение статистики с отбором строк
SOAP
Получение кампаний
Создание объявлений
Python
Получение токена
JSON
Получение кампаний
Создание объявлений
Обработка нехватки баллов
Получение статистики за произвольные даты
Получение статистики с отбором строк
Получение статистики по клиентам агентства
SOAP
Получение кампаний
Создание объявлений
XML
Получение статистики за произвольные даты
Получение статистики с отбором строк
Руководство по переходу
Основные изменения
Соответствие методов
Соответствие параметров
Кампании
Объявления и группы
Фразы и ставки
Визитки
Статистика
Ретаргетинг
Клиенты
Решение проблем
При вызове метода API Яндекс.Директа возникает ошибка
Заявка на доступ
Ограничения при работе с API Яндекс.Директа
Доступ к регистрации новых клиентов агентства через API
Внести предложение или оставить отзыв
Другие вопросы по API Яндекс.Директа
← Ctrl ПредыдущаяСледующая Ctrl →

Clients

Сервис предназначен для управления параметрами рекламодателя и настройками пользователя — представителя рекламодателя, а также для получения параметров агентства и настроек пользователя — представителя агентства.

Методы

update
[no-highlight[

Изменяет параметры рекламодателя и настройки пользователя — представителя рекламодателя.

Подробнее update

]no-highlight]
 | get
[no-highlight[

Возвращает параметры рекламодателя и настройки пользователя — представителя рекламодателя либо параметры агентства и настройки пользователя — представителя агентства.

Подробнее get

]no-highlight]

Адрес WSDL-описания

https://api.direct.yandex.com/v5/clients?wsdl

Адрес для SOAP-запросов

https://api.direct.yandex.com/v5/clients

Адрес для JSON-запросов

https://api.direct.yandex.com/json/v5/clients

См. также