Программный интерфейс AdWords: первые шаги
четверг, июня 30, 2011
Мы уже давали краткое описание 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.new3. Получить экземпляр необходимого сервиса:
campaign_srv = adwords.service(:CampaignService, :v201101)4. Выполнить запрос:
response = campaign_srv.get({
:fields => ['Id', 'Name', 'Status'],
:ordering => [{:field => 'Name',
:sort_order => 'ASCENDING'}]
})Этот и другие примеры доступны в репозитории, так же и для других библиотек.
Дополнительная информация
Более подробную информацию об API можно получить на нашем сайте. Вопросы всегда можно задать форуме.
Автор: Даниил Климкин, команда AdWords API
