Il recupero dei riferimenti alle classi di protocollo quando utilizzi l'API richiede una conoscenza intrinseca dell'API o una ricerca frequente nella documentazione di riferimento dei protocolli per il percorso esatto.
ProtoLookupUtil
L'util di ricerca proto ti consente di cercare e creare istanze di servizi, operazioni, enumerazioni e risorse senza dover tenere traccia dei numeri di versione delle API e degli spazi dei nomi.
Di solito, come puoi creare l'istanza di una campagna:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
Tuttavia, con l'utilità di ricerca proto puoi utilizzare una forma più semplice:
campaign = client.resource.campaign
Quando recupera una risorsa, un servizio o un'operazione, viene restituita un'istanza di quell'entità. Quando recupera un'enumerazione, viene restituito un riferimento alla classe, senza creazione di istanze.
Per le enumerazioni, puoi utilizzare una scorciatoia per ignorare la ricerca dei 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 logica aggiuntiva per trasmettere il token sviluppatore e i dettagli di autenticazione, che dovresti gestire manualmente se utilizzassi un altro metodo.