Первоначальные сведения

Объекты API и взаимосвязи между ними, параметры и функции объектов.

Внимание. Ниже представлены объекты API и взаимосвязи между ними в версии Live 4.

В API необходимо создать по меньшей мере одну кампанию. Она может содержать до 1000 групп объявлений. Каждая группа может содержать до 50 объявлений. Для группы должна быть задана хотя бы одна фраза или ретаргетинг.

Для создания и редактирования объектов в API предусмотрены различные методы.

Техника редактирования объектов

Многие параметры объектов можно не указывать при вызове редактирующих методов. Значения неуказанных параметров заменяются на предустановленные, что не всегда соответствует ожидаемому результату. Чтобы сохранять значения, рекомендуется применять следующую технику редактирования.

Прежде чем редактировать объекты, их параметры получают из API с помощью указанных ниже методов. Методы возвращают полный состав параметров объекта в виде структуры, которую после необходимой модификации параметров подают на вход редактирующего метода. Таким образом в API передаются как измененные, так и прежние значения параметров. Поскольку все параметры явно заданы, замена на предустановленные значения не происходит.

Методы для получения и редактирования параметров
Объект Получение Редактирование
Кампания (Campaign) GetCampaignsParams (Live) CreateOrUpdateCampaign (Live)
Группа объявлений (AdGroup), Объявление (Banner) GetBanners (Live) CreateOrUpdateBanners (Live)
Фраза (Phrase)
Клиент (Client) GetClientInfo (Live) UpdateClientInfo