Pour récupérer des références à des classes proto lors de l'utilisation de l'API, vous devez : vous avez une compréhension intrinsèque de l'API ou devez consulter fréquemment proto pour connaître le chemin d'accès exact.
ProtoLookupUtil
L'utilitaire proto lookup vous permet de rechercher et de créer des instances de services, des opérations, des énumérations et des ressources, sans avoir à suivre l'API les numéros de version et les espaces de noms.
Voici comment instancier généralement une campagne:
campaign = Google::Ads::GoogleAds::V17::Resources::Campaign.new
Mais avec l'utilitaire proto lookup, vous pouvez utiliser une forme plus simple:
campaign = client.resource.campaign
Lors de l'extraction d'une ressource, d'un service ou d'une opération, une instance de cette entité est renvoyé. Lors de la récupération d'une énumération, une référence à la classe est renvoyée. sans instanciation.
Pour les énumérations, vous pouvez utiliser un raccourci pour éviter d'avoir à rechercher la protos d'énumération.
campaign.status = :PAUSED
Nous vous recommandons d'utiliser la méthode client.service pour récupérer les services, même si vous
n'utilisez pas cet utilitaire pour d'autres cas d'utilisation. Il y a une logique supplémentaire
intégrée dans
cette méthode pour transmettre votre jeton de développeur et vos informations d'authentification,
que vous devrez gérer manuellement
si vous utilisiez une autre méthode.