Per recuperare i riferimenti alle classi proto quando utilizzi l'API, devi avere una conoscenza intrinseca dell'API o devi consultare di frequente la documentazione di riferimento del proto per il percorso esatto.
ProtoLookupUtil
Lo strumento 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 dei namespace dell'API.
Di seguito è riportata la procedura di solito utilizzata per creare un'istanza di una campagna:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Tuttavia, con lo strumento di ricerca proto, puoi utilizzare una forma più semplice:
campaign = client.resource.campaign
Quando viene recuperata una risorsa, un servizio o un'operazione, viene restituita un'istanza dell'entità. Quando viene recuperata un'enumerazione, viene restituito un riferimento alla classe senza l'inizializzazione.
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 è dotato di una logica aggiuntiva per trasmettere il token sviluppatore e i dettagli di autenticazione, che dovresti gestire manualmente se utilizzassi un altro metodo.