Основное использование клиентской библиотеки следующее:
Установка
Рекомендуемый способ установки — с помощью bundler . Добавьте строку в Gemfile (заменив xyz на номер интересующей вас версии):
gem 'google-ads-googleads', '~> x.y.z'
Затем выполните:
$ bundle install
Эта команда использует bundler для обновления вашего Gemfile.lock , устанавливая точную версию пакета и все его зависимости, которые были установлены. Пессимистический оператор версии "~> xyz" приводит к тому, что bundle update устанавливает только новые версии серии xy* , поэтому вам необходимо вручную включить новые версии, повторно обновив Gemfile .
Другие варианты установки
Если вы не используете Bundler, вы можете воспользоваться одним из следующих вариантов:
- Установите эту библиотеку с помощью gem:
terminal $ [sudo] gem install google-ads-googleads - Загрузите gem со страницы релизов и установите его из локального файла:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Настроить аутентификацию
Чтобы аутентифицировать вызовы API, следуйте инструкциям на странице «Аутентификация и авторизация» .
Использование
Чтобы включить драгоценный камень в свой код:
require 'google/ads/google_ads'
Чтобы получить определенную службу, например CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Более подробную демонстрацию использования библиотеки можно найти в примерах на GitHub .
После ознакомления с примерами мы также рекомендуем вам ознакомиться с фабриками , которые предоставляют набор высокоуровневых удобных методов для работы с API Google Ads.
Обработка ошибок
Не каждый вызов API будет успешным. Сервер может выдать ошибки, если по какой-либо причине вызовы API завершатся неудачей. Важно отслеживать ошибки API и обрабатывать их соответствующим образом.
При возникновении ошибки API генерируется экземпляр GoogleAdsException . Он содержит подробную информацию, которая поможет вам понять, что пошло не так, и вы можете настроить вспомогательную функцию для обработки ошибок. См. пример обработчика ошибок на GitHub .