Il recupero dei riferimenti alle classi proto quando si utilizza l'API richiede una conoscenza intrinseca dell'API o la necessità di consultare spesso la documentazione di riferimento proto per il percorso esatto.
ProtoLookupUtil
L'utilità di ricerca proto 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 delle API.
Ecco come in genere viene creata un'istanza di una campagna:
campaign = Google::Ads::GoogleAds::V25::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 recuperi un'enumerazione, viene restituito un riferimento alla classe, senza la creazione di un'istanza.
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 i dettagli di autenticazione, che dovresti gestire manualmente se utilizzassi un altro metodo.