Il recupero dei riferimenti alle classi proto quando si utilizza l'API richiede hanno una conoscenza intrinseca dell'API o devono cercare frequentemente documentazione di riferimento del protocollo per il percorso esatto.
ProtoLookupUtil
L'utility di ricerca proto consente di cercare e creare istanze di servizi, operazioni, enumerazioni e risorse senza dover tenere traccia delle API i numeri di versione e gli spazi dei nomi.
Di solito, procedi nel seguente modo per creare un'istanza per una campagna:
campaign = Google::Ads::GoogleAds::V17::Resources::Campaign.new
Con l'utility proto lookup, puoi utilizzare un formato più semplice:
campaign = client.resource.campaign
Quando recupera una risorsa, un servizio o un'operazione, viene eseguita un'istanza di quell'entità restituito. Durante il recupero di un'enumerazione, viene restituito un riferimento alla classe. senza creare un'istanza.
Per le enumerazioni, puoi utilizzare una scorciatoia per bypassare la necessità di cercare il proto di enumerazione.
campaign.status = :PAUSED
Ti consigliamo di utilizzare il metodo client.service per recuperare i servizi anche se
non usare questa utilità per altri casi d'uso. C'è una logica aggiuntiva integrata
questo metodo per trasmettere il token sviluppatore e i dettagli di autenticazione,
che dovresti gestire manualmente se utilizzassi un altro metodo.