Компания Блог Вакансии Разработчикам Рекламодателям

События Наука Обучение

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

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/

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