Para buscar referências a classes proto ao usar a API, é necessário ter um conhecimento intrínseco da API ou consultar com frequência a documentação de referência proto para o caminho exato.
ProtoLookupUtil
O utilitário de pesquisa proto permite pesquisar 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.
Confira como instanciar uma campanha normalmente:
campaign = Google::Ads::GoogleAds::V25::Resources::Campaign.new
No entanto, com o utilitário de pesquisa proto, é possível usar um formulário mais simples:
campaign = client.resource.campaign
Ao buscar 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, é possível usar um atalho para evitar a necessidade de pesquisar os protos de enumeração.
campaign.status = :PAUSED
Recomendamos usar o 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 a esse método para transmitir seus detalhes de autenticação, que você teria que processar manualmente se usasse outro método.