Основное использование клиентской библиотеки выглядит следующим образом:
Установка
Рекомендуемый способ установки — использование 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 .