Utilidad de búsqueda

Para recuperar referencias a las clases proto cuando usas la API, debes tener una comprensión intrínseca de la API o buscar con frecuencia la documentación de referencia de proto para la ruta de acceso exacta.

ProtoLookupUtil

La utilidad de búsqueda de proto te permite buscar y crear instancias de servicios, operaciones, enumeraciones y recursos sin tener que realizar un seguimiento de los números de versión de la API y los espacios de nombres.

Generalmente, a continuación se explica cómo se crea una instancia de una campaña:

campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new

Pero con la utilidad proto lookup, puedes usar una forma más simple:

campaign = client.resource.campaign

Cuando se recupera un recurso, operación o servicio, se muestra una instancia de esa entidad. Cuando se recupera una enumeración, se muestra una referencia a la clase, sin creación de instancias.

En el caso de las enumeraciones, puedes usar un atajo para evitar la necesidad de buscar los prototipos de enumeración.

campaign.status = :PAUSED

Te recomendamos usar el método client.service para recuperar servicios, incluso si no usas esta utilidad para ningún otro caso de uso. Este método tiene una lógica adicional incorporada para pasar los detalles de autenticación y token de desarrollador, que tendrías que controlar de forma manual si usas otro método.