Pour extraire des références aux classes proto lors de l'utilisation de l'API, vous devez soit avoir une compréhension intrinsèque de l'API, soit consulter fréquemment la documentation de référence proto pour connaître le chemin d'accès exact.
ProtoLookupUtil
L'utilitaire de recherche proto vous permet de rechercher et de créer des instances de services, d'opérations, d'énumérations et de ressources sans avoir à suivre les numéros de version et les espaces de noms de l'API.
Voici comment instancier une campagne:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
Mais avec l'utilitaire proto lookup, vous pouvez utiliser une forme plus simple:
campaign = client.resource.campaign
Lors de la récupération d'une ressource, d'un service ou d'une opération, une instance de cette entité est renvoyée. 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 afin de contourner le besoin de rechercher les 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. Une logique supplémentaire est intégrée à 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.