API를 사용할 때 proto 클래스에 대한 참조를 가져오려면 API에 대한 근본적인 이해가 있거나 정확한 경로를 찾기 위해 proto 참조 문서를 자주 찾아봐야 합니다.
ProtoLookupUtil
proto 조회 유틸을 사용하면 API 버전 번호와 네임스페이스를 추적하지 않고도 서비스, 작업, 열거형, 리소스의 인스턴스를 조회하고 만들 수 있습니다.
일반적으로 캠페인을 인스턴스화하는 방법은 다음과 같습니다.
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
하지만 proto lookup 유틸을 사용하면 더 간단한 양식을 사용할 수 있습니다.
campaign = client.resource.campaign
리소스, 서비스 또는 작업을 가져올 때 해당 항목의 인스턴스가 반환됩니다. 열거형을 가져올 때는 인스턴스화 없이 클래스 참조가 반환됩니다.
열거형의 경우 단축키를 사용하여 열거형 프로토를 조회하지 않아도 됩니다.
campaign.status = :PAUSED
다른 사용 사례에 이 유틸리티를 사용하지 않더라도 client.service 메서드를 사용하여 서비스를 가져오는 것이 좋습니다. 이 메서드에는 개발자 토큰 및 인증 세부정보를 전달하는 추가 로직이 내장되어 있습니다. 다른 메서드를 사용했다면 이 작업을 수동으로 처리해야 합니다.