Cuando usas la API, recuperar referencias a clases .proto requiere que tengas un conocimiento intrínseco de la API o que consultes con frecuencia la documentación de referencia de .proto para conocer la ruta exacta.
ProtoLookupUtil
La utilidad de búsqueda de .proto te permite buscar y crear instancias de servicios, operaciones, enumeraciones y recursos sin tener que hacer un seguimiento de los números de versión y los espacios de nombres de la API.
A continuación, se muestra cómo, por lo general, se crea una instancia de una campaña:
campaign = Google::Ads::GoogleAds::V20::Resources::Campaign.new
Sin embargo, con la utilidad de búsqueda de .proto, puedes usar una forma más simple:
campaign = client.resource.campaign
Cuando se recupera un recurso, un servicio o una operación, se devuelve una instancia de esa entidad. Cuando se recupera una enumeración, se devuelve una referencia a la clase, sin instanciación.
En el caso de las enumeraciones, puedes usar un atajo para evitar la necesidad de buscar los protos de enumeración.
campaign.status = :PAUSED
Te recomendamos que uses el método client.service
para recuperar servicios, incluso si no usas esta utilidad para ningún otro caso de uso. Este método incluye lógica adicional para pasar tu token de desarrollador y los detalles de autenticación, que tendrías que controlar manualmente si usaras otro método.