Pour extraire des références aux classes proto lorsque vous utilisez 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 exact.
ProtoLookupUtil
L'utilitaire de recherche de fichiers .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 des API.
Voici comment instancier une campagne :
campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new
Toutefois, avec l'utilitaire de recherche de proto, 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 pour éviter d'avoir à 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. Cette méthode intègre une logique supplémentaire pour transmettre votre jeton de développeur et vos informations d'authentification, que vous devriez gérer manuellement si vous utilisiez une autre méthode.