Lorsque vous utilisez l'API, vous devez récupérer des références aux classes proto. Pour cela, 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 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 vous instanciez généralement une campagne :
campaign = Google::Ads::GoogleAds::V25::Resources::Campaign.new
Toutefois, avec l'utilitaire de recherche 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. Lorsque vous récupérez 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 des 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 vos identifiants d'authentification, que vous devriez gérer manuellement si vous utilisiez une autre méthode.