API AdWords версии 2009 является результатом фундаментального изменения API, обеспечивающим большее функциональное равенство с интерфейсом AdWords. Начав с чистого листа, мы также смогли реорганизовать API так, чтобы функции, добавленные с момента выпуска версии 1, предоставлялись более удобно. Вот несколько изменений, которые можно обнаружить в версии 2009:
| 
get и mutate.Хотя версия 2009 на первый взгляд выглядит совершенно иначе, фундаментальные принципы API AdWords сохранены:
Эта документация по версии 2009 предполагает, что вы пользовались предыдущими версиями API AdWords. Если вы только начали использовать API AdWords, ознакомьтесь с документацией по версии 13, чтобы подробнее узнать об этих веб-службах.
Чтобы помочь вам перейти с версии 13 на версию 2009, мы предоставляем статью Переход на версию 2009, в которой описаны изменения, которые вам потребуется внести в свое клиентское приложение.
В следующей таблице показаны различия между веб-службами версий 13 и 2009.
| v13 | v2009 |
|---|---|
| CampaignService | CampaignService |
| часть службы CriterionService | CampaignCriterionService |
| часть службы CampaignService | CampaignTargetService |
| AdGroupService | AdGroupService |
| AdService | AdGroupAdService |
| CriterionService | AdGroupCriterionService |
В настоящее время API AdWords версии 2009 не предоставляет веб-служб вне области управления данными кампании. Вспомогательные службы (ReportService, InfoService, AccountService и т.д.) будут добавлены в следующем выпуске. До тех пор используйте вспомогательные службы из версии 13 вместе с службами управления данными кампании из версии 2009.
Две операции определены для всех веб-служб API AdWords версии 2009:
Операция get принимает объект фильтра *Selector для данной службы, который позволяет получать объекты в зависимости от их идентификаторов, статусов, диапазонов дат и других критериев. Кроме того, с помощью операции get можно получать статистические данные. Для этого нужно задать поле statsSelector.
Операция mutate принимает массив объектов *Operation для данной службы, каждый из которых содержит операнд и оператор (ADD, REMOVE или SET). Это мощное обобщение позволяет выполнять по несколько различных операций в одном вызове.
Вместо отправки вашего адреса электронной почты и пароля в заголовке запроса в API AdWords версии 2009 требуется выполнять аутентификацию с помощью защищенного маркера, который можно получить через API Google ClientLogin. authToken заменяет заголовки email и password, а также позволяет отправлять учетные данные входа, не раскрывая свой пароль.