API를 사용할 때 proto 클래스에 대한 참조를 가져오려면 API를 본질적으로 이해하거나 정확한 네임스페이스 경로에 대한 proto 참고 문서를 자주 조회해야 합니다.
ProtoLookupUtil
GoogleAdsClient의 조회 유틸리티 메서드 (팩토리 및 ServiceLookup로 지원되며 기존 ProtoLookupUtil 클래스 대체)를 사용하면 API 버전 번호와 모듈 네임스페이스를 추적하지 않고도 서비스, 작업, 열거형, 리소스의 인스턴스를 조회하고 만들 수 있습니다. 기본적으로 이러한 메서드는 설치된 gem에서 지원하는 가장 높은 API 버전을 사용합니다 (최신 출시 버전에서는 V25, 여기서 v25.1과 같은 부 API 버전은 메이저 버전 모듈 V25 사용). 또는 조회 호출에서 명시적 버전 접두사 (예: v25)를 지정할 수 있습니다.
조회 유틸리티가 없으면 버전이 지정된 네임스페이스에서 직접 캠페인 리소스를 인스턴스화합니다.
campaign =
Google::Ads::GoogleAds::V25::Resources::Campaign.new
클라이언트 조회 메서드를 사용하면 클라이언트에서 직접 리소스를 인스턴스화할 수 있습니다.
campaign = client.resource.campaign
리소스, 서비스 또는 작업을 가져올 때 해당 항목의 인스턴스가 반환됩니다.
# Instantiate an operation
operation = client.operation.campaign
서비스 조회
다른 항목에 이 유틸리티를 사용하지 않더라도 client.service 메서드를 사용하여 서비스 클라이언트를 가져옵니다. client.service는 반환된 서비스 클라이언트에서 인증 사용자 인증 정보와 전송 설정을 자동으로 구성합니다.
campaign_service = client.service.campaign
열거 조회
protobuf 메시지의 enum 필드의 경우 열거형 모듈을 조회하는 대신 Ruby 심볼을 직접 할당합니다.
campaign.status = :PAUSED
런타임에 열거형의 모든 유효한 기호를 검사하거나 반복하려면 해당 열거형의 Google::Protobuf::EnumDescriptor를 반환하는 client.enum를 사용하세요.
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }