Para buscar referências a classes proto ao usar a API, é necessário ter um entendimento intrínseco da API ou consultar com frequência a documentação de referência do proto para encontrar o caminho exato.
ProtoLookupUtil
O utilitário de pesquisa de 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 da API e os namespaces.
Confira como você normalmente instancia uma campanha:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Mas com o utilitário de pesquisa de proto, você pode usar uma forma 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, você pode usar um atalho para contornar a necessidade de pesquisar 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
a esse método para transmitir o token de desenvolvedor e os detalhes de autenticação, que
você precisaria processar manualmente se usasse outro método.