Il recupero dei riferimenti alle classi proto quando utilizzi l'API richiede che tu abbia una conoscenza intrinseca dell'API o che tu debba consultare spesso la documentazione di riferimento di proto per il percorso esatto.
ProtoLookupUtil
L'utilità di ricerca proto ti consente di cercare e creare istanze di servizi, operazioni, enumerazioni e risorse senza dover tenere traccia dei numeri di versione e degli spazi dei nomi dell'API.
Ecco come viene in genere creata un'istanza di una campagna:
campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new
Tuttavia, con l'utilità di ricerca proto, puoi utilizzare un modulo più semplice:
campaign = client.resource.campaign
Quando recuperi una risorsa, un servizio o un'operazione, viene restituita un'istanza di questa entità. Quando viene recuperata un'enumerazione, viene restituito un riferimento alla classe, senza istanziazione.
Per le enumerazioni, puoi utilizzare una scorciatoia per evitare di dover cercare i proto di enumerazione.
campaign.status = :PAUSED
Ti consigliamo di utilizzare il metodo client.service per recuperare i servizi anche se non utilizzi questa utilità per altri casi d'uso. Questo metodo include una logica aggiuntiva per trasmettere il token sviluppatore e i dettagli di autenticazione, che dovresti gestire manualmente se utilizzassi un altro metodo.