Документация
API версии 4 и Live 4
Методы
Отключенные методы

Изменения в структурах данных

25 апреля 2016 года произошли следующие изменения в структурах данных:

  • Тип параметров BannerID, AdID, AdGroupID изменился на long.
  • Тип параметров Banner, BannerIDS, AdIDS изменился на ArrayOfLong.
  • Тип структуры Banners изменился на GetChangesLongData.
Изменены типы данных в WSDL-описании. SOAP- и JSON-запросы принимают на вход и возвращают новые типы данных для указанных выше полей.

Затронутые структуры и методы API
СтруктураМетоды (версия 4)Методы (версия Live 4)
BannerPhraseInfo
GetBanners
[no-highlight[

Возвращает параметры объявлений и фраз.

Подробнее GetBanners

]no-highlight]
GetBannerPhrases
[no-highlight[

Возвращает информацию о фразах.

Подробнее GetBannerPhrases

]no-highlight]
GetBannerPhrasesFilter
[no-highlight[

Возвращает информацию о фразах и позволяет ограничить состав возвращаемых данных.

Подробнее GetBannerPhrasesFilter

]no-highlight]
CreateOrUpdateBanners
[no-highlight[

Создает объявление и фразы или изменяет существующее объявление и фразы.

Подробнее CreateOrUpdateBanners

]no-highlight]
GetBanners (Live)
[no-highlight[

Возвращает параметры групп объявлений, объявлений и фраз.

Подробнее GetBanners (Live)

]no-highlight]
GetBannerPhrases (Live)
[no-highlight[

Возвращает информацию о фразах.

Подробнее GetBannerPhrases (Live)

]no-highlight]
GetBannerPhrasesFilter (Live)
[no-highlight[

Возвращает информацию о фразах и позволяет ограничить состав возвращаемых данных.

Подробнее GetBannerPhrasesFilter (Live)

]no-highlight]
CreateOrUpdateBanners (Live)
[no-highlight[

Создает или изменяет группы объявлений, объявления и фразы.

Подробнее CreateOrUpdateBanners (Live)

]no-highlight]
BannerInfo
GetBanners
[no-highlight[

Возвращает параметры объявлений и фраз.

Подробнее GetBanners

]no-highlight]
CreateOrUpdateBanners
[no-highlight[

Создает объявление и фразы или изменяет существующее объявление и фразы.

Подробнее CreateOrUpdateBanners

]no-highlight]
GetBanners (Live)
[no-highlight[

Возвращает параметры групп объявлений, объявлений и фраз.

Подробнее GetBanners (Live)

]no-highlight]
CreateOrUpdateBanners (Live)
[no-highlight[

Создает или изменяет группы объявлений, объявления и фразы.

Подробнее CreateOrUpdateBanners (Live)

]no-highlight]

GetBannersInfo

GetBanners
[no-highlight[

Возвращает параметры объявлений и фраз.

Подробнее GetBanners

]no-highlight]
GetBanners (Live)
[no-highlight[

Возвращает параметры групп объявлений, объявлений и фраз.

Подробнее GetBanners (Live)

]no-highlight]
BannerPhrasesFilterRequestInfo GetBannerPhrasesFilter
[no-highlight[

Возвращает информацию о фразах и позволяет ограничить состав возвращаемых данных.

Подробнее GetBannerPhrasesFilter

]no-highlight]
GetBannerPhrasesFilter (Live)
[no-highlight[

Возвращает информацию о фразах и позволяет ограничить состав возвращаемых данных.

Подробнее GetBannerPhrasesFilter (Live)

]no-highlight]
CampaignBidsInfo
ArchiveBanners
[no-highlight[

Помещает объявления в архив.

Подробнее ArchiveBanners

]no-highlight]
DeleteBanners
[no-highlight[

Удаляет объявления.

Подробнее DeleteBanners

]no-highlight]
ModerateBanners
[no-highlight[

Отправляет на модерацию объявления в статусе «Черновик».

Подробнее ModerateBanners

]no-highlight]
ResumeBanners
[no-highlight[

Разрешает показ объявлений.

Подробнее ResumeBanners

]no-highlight]
StopBanners
[no-highlight[

Останавливает показ объявлений.

Подробнее StopBanners

]no-highlight]
UnArchiveBanners
[no-highlight[

Извлекает объявления из архива.

Подробнее UnArchiveBanners

]no-highlight]
ArchiveBanners (Live)
[no-highlight[

Помещает объявления в архив.

Подробнее ArchiveBanners (Live)

]no-highlight]
DeleteBanners (Live)
[no-highlight[

Удаляет объявления.

Подробнее DeleteBanners (Live)

]no-highlight]
ModerateBanners (Live)
[no-highlight[

Отправляет на модерацию объявления в статусе «Черновик».

Подробнее ModerateBanners (Live)

]no-highlight]
ResumeBanners (Live)
[no-highlight[

Разрешает показ объявлений.

Подробнее ResumeBanners (Live)

]no-highlight]
StopBanners (Live)
[no-highlight[

Останавливает показ объявлений.

Подробнее StopBanners (Live)

]no-highlight]
UnArchiveBanners (Live)
[no-highlight[

Извлекает объявления из архива.

Подробнее UnArchiveBanners (Live)

]no-highlight]
PhrasePriceInfo SetAutoPrice
[no-highlight[

Задает или рассчитывает по алгоритму ставки для фраз.

Подробнее SetAutoPrice

]no-highlight]
UpdatePrices
[no-highlight[

Задает ставки и/или приоритеты для указанных фраз.

Подробнее UpdatePrices

]no-highlight]
SetAutoPrice (Live)
[no-highlight[

Задает или рассчитывает по алгоритму ставки для фраз.

Подробнее SetAutoPrice (Live)

]no-highlight]
UpdatePrices (Live)
[no-highlight[

Задает ставки и/или приоритеты для указанных фраз.

Подробнее UpdatePrices (Live)

]no-highlight]
AutoPriceInfo SetAutoPrice (Live)
[no-highlight[

Задает или рассчитывает по алгоритму ставки для фраз.

Подробнее SetAutoPrice (Live)

]no-highlight]
NewReportFilterInfo CreateNewReport
[no-highlight[

Запускает на сервере формирование отчета о статистике кампании.

Подробнее CreateNewReport

]no-highlight]
CreateNewReport (Live)
[no-highlight[

Запускает на сервере формирование отчета о статистике кампании.

Подробнее CreateNewReport (Live)

]no-highlight]
BannersStatItem GetBannersStat (Live)
[no-highlight[

Возвращает статистику указанной кампании за период не более семи дней.

Подробнее GetBannersStat (Live)

]no-highlight]

BannersRequestInfo

GetBannersTags (Live)
[no-highlight[

Возвращает идентификаторы меток, присвоенных объявлениям.

Подробнее GetBannersTags (Live)

]no-highlight]
BannerTagsInfo
GetBannersTags (Live)
[no-highlight[

Возвращает идентификаторы меток, присвоенных объявлениям.

Подробнее GetBannersTags (Live)

]no-highlight]
UpdateBannersTags (Live)
[no-highlight[

Присваивает метки объявлениям.

Подробнее UpdateBannersTags (Live)

]no-highlight]

GetEventsLogFilter

EventsLogItem

GetEventsLog (Live)
[no-highlight[

Возвращает записи из журнала событий.

Подробнее GetEventsLog (Live)

]no-highlight]

GetChangesRequest

GetChangesResponse

GetChanges
[no-highlight[

Проверяет наличие изменений в кампаниях, объявлениях и персональных данных клиентов, а также в справочнике регионов, справочнике временных зон, в Яндекс.Каталоге.

Подробнее GetChanges

]no-highlight]

Retargeting

RetargetingSelectionCriteria

Retargeting (Live)

AdImageAssociation

AdImageAssociationSelectionCriteria

AdImageAssociationActionResult

AdImageAssociation (Live)

Рекомендации разработчикам

Если ваше приложение разработано на строго типизированном языке программирования (например, Java, С/С++, C#) и взаимодействует с API Яндекс.Директа по протоколу SOAP, скачайте новое WSDL-описание и заново сформируйте структуры данных.

В следующих адресах типы данных были изменены заблаговременно.

Версия 4Версия Live 4

Адрес WSDL:

https://api.direct.yandex.ru/v4/wsdl/2/

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

https://api.direct.yandex.ru/v4/soap/2/

Адрес WSDL:

https://api.direct.yandex.ru/live/v4/wsdl/2/

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

https://api.direct.yandex.ru/live/v4/soap/2/

В настоящее время данные адреса и основные адреса работают идентично.