Команда API Директа сообщила о начале первого этапа перехода некоторых устаревших методов API 4 и Live 4 на соответствующие сервисы API 5.
Через неделю при вызове некоторых методов версии API 4 периодически будет выдаваться ошибка 59 об ограничении использования этих методов и необходимости перехода на API 5. Ниже приводится полный список методов, которые затронут эти изменения.
Через две недели после планируется начало второго этапа перехода: указанные методы в API 4 будут полностью отключены. Методы API 4 Live будут закрыты немного позднее – ориентировочно в 20-х числах августа.
Список методов API 4, запланированных к закрытию через 2 недели:
CreateOrUpdateCampaign, GetCampaignsList, GetCampaignsListFilter, GetCampaignsParams, GetCampaignParams, DeleteCampaign, ResumeCampaign, StopCampaign, ArchiveCampaign, UnArchiveCampaign, CreateOrUpdateBanners, GetBanners, DeleteBanners, ModerateBanners, ResumeBanners, StopBanners, ArchiveBanners, UnArchiveBanners, GetBannerPhrases, GetBannerPhrasesFilter, SetAutoPrice, UpdatePrices, GetChanges.
Список методов API Live 4, запланированных к закрытию в августе:
CreateOrUpdateCampaign (Live), GetCampaignsList (Live), GetCampaignsListFilter (Live), GetCampaignsParams (Live), GetCampaignParams (Live), DeleteCampaign (Live), ResumeCampaign (Live), StopCampaign (Live), ArchiveCampaign (Live), UnArchiveCampaign (Live), CreateOrUpdateBanners (Live), GetBanners (Live), DeleteBanners (Live), ModerateBanners (Live), ResumeBanners (Live), StopBanners (Live), ArchiveBanners (Live), UnArchiveBanners (Live), Keyword (Live), GetBannerPhrases (Live), GetBannerPhrasesFilter (Live), SetAutoPrice (Live), UpdatePrices (Live), GetChanges (Live).
Напоминаем, первые методы API 5 — нового программного интерфейса Директа с полностью перестроенной архитектурой, появились в открытом доступе в конце июня 2015 года. Среди ключевых особенностей API 5, можно назвать наличие отдельных веб-сервисов для операций с разными классами объектов, у каждого из которых есть свой унифицированный набор методов. Такая архитектура позволяет работать только с нужными наборами данных, не выгружая все связанные с ними дополнительные параметры, и легко встраивать новые функции с поддержкой обратной совместимости.
В документации в разделе «Руководство по переходу» можно найти всю информацию о соответствии методов и их параметров в версиях API 4 и Live 4 и API 5 — для корректной миграции приложений на пятую версию API.
