Яндекс.Директ получил API 5

03.07.2015

Команда API Яндекс.Директа сообщает о появлении в свободном доступе первых методов API 5 - новейшего программного интерфейса Директа с глубоко переработанной архитектурой.

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

Все ошибки и объекты теперь документируются более подробно. В конце операции пользователь получает Id всех объектов и подробный отчет относительно всех объектов внутри запроса. Это означает, что если в процессе приключится ошибка, будет известно точно, где именно возникла та или иная проблема, а какие объекты были успешно созданы или отредактированы.

В API 5 значительно меньше ограничений, а также более гибкая система баллов. Были убраны практически все суточные ограничения на количество запросов с применением одного и того же метода, так что теперь каждый сам сможет решать, на какие операции лучше потратить баллы. Сами же баллы списываются после каждой операции и рассчитываются точнее, поскольку для мелких правок больше не нужно выгружать и загружать обратно полностью всю кампанию. Они начисляются не раз в сутки, единоразово, а равномерно в течение всего дня. Посмотреть информацию о том, сколько баллов потрачено за операцию и какое их количество еще осталось на сегодня, можно в полученном ответе сервера.

Названия методов стали максимально приближенными к международному обиходу, дабы в них проще было сориентироваться. Banner переименован в Ad, Phrase — в Keyword и т.д.

Как считают разработчики, API 5 в разы удобнее и быстрее прошлых версий. В течение года он будет функционировать в виде надстройки к уже привычному API 4 live, благодаря чему можно параллельно использовать новые и старые методы, постепенно переключаясь на работу с новой версией и оптимизируя рутинные операции.

Текущие версии 4 и 4 live будут убраны только в 2016 году, о чем будет анонсировано дополнительно. Лучше не откладывать ознакомление с новой версией на потом, ведь все свежие форматы и надстройки в Директе будут поддерживаться именно в API 5. Уже сегодня в нем можно осуществлять управление ставками и оперировать рекламными материалами: прописывать группы и объявления, добавлять ключевики, визитки и быстрые ссылки.

Изучить новый API 5 можно в документации, где также содержится и руководство по успешному переходу на новую версию.