Pour récupérer des références à des 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 du proto pour obtenir le chemin d'accès exact.
ProtoLookupUtil
L'utilitaire de recherche de 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 créer une instance de campagne de manière courante:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Toutefois, avec l'utilitaire de recherche de proto, vous pouvez utiliser une forme plus simple:
campaign = client.resource.campaign
Lorsque vous récupérez une ressource, un service ou 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 extraire 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 les informations d'authentification, que vous auriez dû gérer manuellement si vous aviez utilisé une autre méthode.