조회 유틸리티

API를 사용할 때 proto 클래스에 대한 참조를 가져오려면 API를 내재적으로 이해하거나 정확한 경로에 대한 proto 참조 문서를 자주 조회해야 합니다.

ProtoLookupUtil

프로토 조회 유틸리티를 사용하면 API 버전 번호와 네임스페이스를 추적하지 않고도 서비스, 작업, 열거형, 리소스의 인스턴스를 조회하고 만들 수 있습니다.

일반적으로 캠페인을 인스턴스화하는 방법은 다음과 같습니다.

campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new

하지만 프로토 조회 유틸리티를 사용하면 더 간단한 형식을 사용할 수 있습니다.

campaign = client.resource.campaign

리소스, 서비스 또는 작업을 가져올 때 해당 항목의 인스턴스가 반환됩니다. 열거형을 가져올 때 인스턴스화 없이 클래스 참조가 반환됩니다.

열거형의 경우 단축키를 사용하여 열거형 프로토콜을 조회할 필요가 없습니다.

campaign.status = :PAUSED

다른 사용 사례에 이 유틸리티를 사용하지 않더라도 client.service 메서드를 사용하여 서비스를 가져오는 것이 좋습니다. 이 메서드에는 개발자 토큰과 인증 세부정보를 전달하는 추가 로직이 내장되어 있으며, 다른 메서드를 사용하는 경우 이를 수동으로 처리해야 합니다.