API를 사용할 때 프로토 클래스에 대한 참조를 가져오려면 API를 기본적으로 이해하고 있거나 정확한 네임스페이스 경로에 대한 프로토 참고 문서를 자주 조회해야 합니다.
ProtoLookupUtil
GoogleAdsClient의 조회 유틸리티 메서드 (팩토리 및 ServiceLookup에서 지원하며 기존 ProtoLookupUtil 클래스 대체)를 사용하면 API 버전 번호와 모듈 네임스페이스를 추적하지 않고도 서비스, 작업, 열거, 리소스의 인스턴스를 조회하고 만들 수 있습니다. 기본적으로 이러한 메서드는 설치된 gem에서 지원하는 가장 높은 API 버전 (V26은 최신 출시 버전, v25.1과 같은 부 API 출시 버전은 기본 버전 모듈 V25 사용)을 사용합니다. 또는 조회 호출에서 명시적 버전 접두어 (예: v26)를 지정할 수 있습니다.
조회 유틸리티가 없으면 버전이 지정된 네임스페이스에서 캠페인 리소스를 직접 인스턴스화합니다.
campaign =
Google::Ads::GoogleAds::V26::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
런타임에 열거의 모든 유효한 기호를 검사하거나 반복하려면 해당 enum의 Google::Protobuf::EnumDescriptor를 반환하는 client.enum을 사용합니다.
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }