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