클라이언트 라이브러리의 기본 사용법은 다음과 같습니다.
설치
라이브러리를 설치하는 권장 방법은 Bundler를 사용하는 것입니다. Gemfile에 줄을 추가합니다(x.y.z를 사용하려는 버전 번호로 바꿈).
gem 'google-ads-googleads', '~> x.y.z'
그런 후 다음을 실행합니다.
bundle install
이 명령어는 Bundler를 사용하여 Gemfile.lock를 업데이트하고 설치된 gem의 정확한 버전과 gem의 모든 종속 항목을 잠급니다. 비관적 버전 연산자 "~> x.y.z"는 bundle install 또는 bundle update가 x.y.* 시리즈의 새 패치 버전만 설치하도록 보장하므로 Gemfile를 업데이트하여 새 부 버전 또는 메이저 버전을 수동으로 선택해야 합니다.
기타 설치 옵션
Bundler를 사용하지 않는 경우 다음 옵션 중 하나를 사용할 수 있습니다.
RubyGems를 사용하여 이 라이브러리를 설치합니다.
gem install google-ads-googleads출시 페이지에서 gem을 다운로드하고 로컬 파일에서 설치합니다.
gem install google-ads-googleads-[version].gem
인증 설정
API 호출을 인증하려면 google_ads_config.rb 파일을 구성하고 인증 및 승인 페이지의 안내를 따르세요.
사용
google-ads-googleads v41.1.0부터 gem은 Bundler autorequire (Bundler.require)를 지원합니다. v41.1.0 이전 버전 (또는 Bundler.require를 사용하지 않는 경우)에서는 코드에 gem을 명시적으로 요구합니다.
require 'google/ads/google_ads'
클라이언트를 초기화하고 (기본적으로 ~/google_ads_config.rb에서 구성을 로드함) CampaignService와 같은 특정 서비스를 가져옵니다.
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
campaign_service = client.service.campaign
라이브러리 사용 방법에 관한 자세한 데모는 GitHub의 예시를 참고하세요.
예시에 익숙해지면 Google Ads API를 사용하기 위한 일련의 고급 편의 메서드를 제공하는 팩토리를 살펴보세요.
오류 처리
모든 API 호출이 성공하는 것은 아닙니다. API 호출이 실패하면 서버에서 예외가 발생합니다. API 오류를 포착하고 적절하게 처리하는 것이 중요합니다.
API 오류가 발생하면 Google::Ads::GoogleAds::Errors::GoogleAdsError 인스턴스가 발생합니다. 여기에는 무엇이 잘못되었는지 파악하는 데 도움이 되는 세부정보가 포함되어 있으며, 오류를 처리하는 도우미 함수를 설정할 수 있습니다. GitHub의 오류 핸들러 예시를 참조하세요.