구성

구성은 Config 클래스를 사용하여 실행됩니다. 여러 위치에서 이 수업에 액세스할 수 있습니다. 구성 파일 작성, 생성 시 값 지정, 환경 변수에서 값을 로드합니다.

구성 파일

포드의 google_ads_config.rb 드림 파일을 만듭니다.

인스턴스화할 때 인수를 사용하지 않는 경우:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

그러면 라이브러리는 GOOGLE_ADS_CONFIGURATION_FILE_PATH 환경 변수입니다. 이 변수가 설정되지 않은 경우 라이브러리는 HOME 디렉터리에서 파일을 찾습니다.

또는 경로를 지정할 수 있습니다.

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

이 경우 클라이언트는 해당 파일 경로에서 파일을 찾습니다.

이 파일을 생성하는 가장 쉬운 방법은 google_ads_config.rb GitHub 저장소에 액세스하고 갱신 토큰, 클라이언트 ID, 클라이언트 보안 비밀번호를 설정합니다

동적 구성

라이브러리를 인스턴스화할 때 구성을 동적으로 설정할 수 있습니다. 또는 그 이후에도:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

인스턴스화한 후에도 구성을 수정할 수 있습니다.

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

구성 필드

Config 객체는 다음 필드를 지원합니다.

일반 필드:

  • refresh_token: OAuth 갱신 토큰입니다.
  • client_id: OAuth 클라이언트 ID입니다.
  • client_secret: OAuth 클라이언트 보안 비밀번호입니다.
  • developer_token: API에 액세스하기 위한 개발자 토큰입니다.
  • login_customer_id: login-customer-id 문서를 참조하세요.

로깅 필드 자세한 내용은 로깅 가이드를 참조하세요.

  • log_level: 로깅할 최소 로그 수준 메시지입니다. 예를 들어 'DEBUG'를 지정하면 모든 로그 메시지가 표시되고 'INFO'에서는 DEBUG 메시지를 제외하고 다른 메시지를 모두 표시합니다.
  • log_target: 로깅할 위치(예: STDERR)
  • logger: 고유한 커스텀 로거를 지정합니다. 이를 지정하면 log_levellog_target

환경 변수

환경 변수를 사용하여 클라이언트 라이브러리를 구성할 수 있습니다. 그렇지 않습니다. 기본적으로 로드되며, 클라이언트로 전송해야 합니다 환경 변수의 전체 목록 보기 모두 지원 언어를 참조하세요.

환경 변수를 Config에 로드하려면 load_environment_config를 호출합니다.

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

이 함수가 호출될 때마다 환경 변수의 현재 상태는 Config에 이미 있는 모든 항목을 덮어씁니다. 이 예를 들어 기본 구성을 설정하되 특정 환경 변수를 사용하여 해당 값을 지정할 수도 있고, 환경 변수입니다

모든 라이브러리에서 지원되는 환경 변수 외에도 Ruby는 라이브러리에는 다음과 같은 두 개의 추가 변수가 있습니다.

  • GOOGLE_ADS_RUBY_LOG_LEVEL: 위의 log_level와 같습니다.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: HTTP 프록시를 지정합니다.