Мы уже давали краткое описание AdWords API и его возможностей. Пришло время перейти от теории к практике. В этой статье я кратко расскажу, как установить одну из клиентских библиотек и сделать первый вызов к интерфейсу.

Здесь и далее я рассчитываю, что у вас уже есть аккаунт в AdWords, а также создан MCC аккаунт и предоставлен ключ разработчика (токен). Аккаунты должны быть связаны.

Установка клиентской библиотеки

В качестве примера рассмотрю библиотеку Ruby для платформы GNU / Linux. Данную библиотеку можно скачать с нашего сайта или установить стандартными средствами платформы. Библиотеки для других языков можно найти здесь.

Установим библиотеку стандартными средствами (ruby 1.8):
$ gem install google-adwords-api

Настройки данных авторизации

Есть несколько способов задать данные для авторизации (см. README), но самый простой из них - конфигурационный файл по умолчанию. Он идет в пакете библиотек, а также доступен в репозитории. Внесем необходимые изменения и сохраним его как adwords_api.yml в домашнем каталоге:
---
:authentication:
:method: ClientLogin
:developer_token: ваш_ключ_разработчика
:user_agent: идентификатор_приложения
:email: логин_для_авторизации
:password: пароль_для_авторизации
:client_email: логин_клиентского_аккаунта
:service:
:environment: Sandbox

Необходимо указать логин и пароль MCC-аккаунта и ваш ключ разработчика. Логин (или цифровой идентификатор) клиентского аккаунта указывается только если необходимо работать с данными конкретного клиента. Поле ‘environment’ указывает на то, что мы будем обращаться к тестовой среде (sandbox). Обращаю внимание, что для работы с sandbox ключ разработчика получать не нужно, см. документацию.

Выполнение первого запроса

Всё готово, можно выполнять запрос. Для этого необходимо:

1. Подключить библиотеку adwords_api:
require 'adwords_api'
2. Создать объект AdwordsApi:
adwords = AdwordsApi::Api.new
3. Получить экземпляр необходимого сервиса:
campaign_srv = adwords.service(:CampaignService, :v201101)
4. Выполнить запрос:
response = campaign_srv.get({
:fields => ['Id', 'Name', 'Status'],
:ordering => [{:field => 'Name',
:sort_order => 'ASCENDING'}]
})

Этот и другие примеры доступны в репозитории, так же и для других библиотек.

Дополнительная информация

Более подробную информацию об API можно получить на нашем сайте. Вопросы всегда можно задать форуме.

Автор: Даниил Климкин, команда AdWords API