Buscar referências a classes proto ao usar a API exige que você: têm uma compreensão intrínseca da API ou precisam consultar com frequência proto para ver o caminho exato.
ProtoLookupUtil
O util proto lookup permite procurar e criar instâncias de serviços, operações, enumerações e recursos sem ter que acompanhar a API números de versão e namespaces.
Normalmente, você instancia uma campanha da seguinte maneira:
campaign = Google::Ads::GoogleAds::V17::Resources::Campaign.new
Mas com o utilitário de pesquisa do proto, você pode usar um formulário mais simples:
campaign = client.resource.campaign
Ao buscar um recurso, serviço ou operação, uma instância dessa entidade retornados. Ao buscar uma enumeração, é retornada uma referência à classe, sem instanciação.
Para enumerações, você pode usar um atalho para ignorar a necessidade de procurar o de enumeração.
campaign.status = :PAUSED
Recomendamos usar o método client.service para buscar serviços, mesmo que você
não utilize esse utilitário para nenhum outro caso de uso. Existe uma lógica extra incorporada
método para transmitir seu token de desenvolvedor e detalhes de autenticação, que
você teria que lidar manualmente se usasse outro método.