A busca de referências a classes proto ao usar a API exige que você tenha uma compreensão intrínseca da API ou precise consultar com frequência a documentação de referência do proto para ver o caminho exato.
ProtoLookupUtil
O utilitário proto lookup permite procurar e criar instâncias de serviços, operações, enumerações e recursos sem precisar acompanhar os números de versão e os namespaces da API.
Normalmente, veja como instanciar uma campanha:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
Mas com o utilitário proto lookup, é possível usar um formulário mais simples:
campaign = client.resource.campaign
Durante a busca de um recurso, serviço ou operação, uma instância dessa entidade é retornada. Ao buscar uma enumeração, uma referência à classe é retornada, sem instanciação.
Para enumerações, use um atalho para ignorar a necessidade de procurar os protos de enumeração.
campaign.status = :PAUSED
Recomendamos o uso do método client.service
para buscar serviços, mesmo que você
não use esse utilitário para outros casos de uso. Há uma lógica extra integrada
nesse método para transmitir o token de desenvolvedor e os detalhes de autenticação, que
você terá que processar manualmente se usar outro método.