Utilitário Lookup

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.