Voici l'utilisation de base de la bibliothèque cliente :
Installation
Nous vous recommandons d'installer la bibliothèque à l'aide de Bundler. Ajoutez une ligne à votre fichier Gemfile (en remplaçant x.y.z par le numéro de version que vous souhaitez utiliser) :
gem 'google-ads-googleads', '~> x.y.z'
Exécutez ensuite la commande ci-dessous :
bundle install
Cette commande utilise Bundler pour mettre à jour votre fichier Gemfile.lock, en le verrouillant sur la version exacte du gem et de toutes les dépendances du gem qui ont été installées. L'opérateur de version pessimiste "~> x.y.z" garantit que bundle install ou bundle update n'installe que les nouvelles versions de correctifs de la série x.y.*. Vous devez donc activer manuellement les nouvelles versions mineures ou majeures en mettant à jour votre Gemfile.
Autres options d'installation
Si vous n'utilisez pas Bundler, vous pouvez utiliser l'une des options suivantes :
Installez cette bibliothèque à l'aide de RubyGems :
gem install google-ads-googleadsTéléchargez le gem depuis la page des versions et installez-le à partir du fichier local :
gem install google-ads-googleads-[version].gem
Configurer l'authentification
Pour authentifier vos appels d'API, configurez votre fichier google_ads_config.rb et suivez les instructions de la page Authentification et autorisation.
Utilisation
À partir de google-ads-googleads v41.1.0, le gem prend en charge l'autorequire Bundler (Bundler.require). Dans les versions antérieures à v41.1.0 (ou lorsque vous n'utilisez pas Bundler.require), exigez explicitement le gem dans votre code :
require 'google/ads/google_ads'
Initialisez le client (qui charge la configuration à partir de ~/google_ads_config.rb par défaut) et récupérez un service spécifique, tel que CampaignService :
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
campaign_service = client.service.campaign
Pour obtenir des démonstrations plus détaillées sur l'utilisation de la bibliothèque, consultez les exemples sur GitHub.
Une fois que vous êtes familiarisé avec les exemples, explorez les factories, qui fournissent un ensemble de méthodes pratiques de haut niveau pour travailler avec l'API Google Ads.
Gestion des exceptions
Tous les appels d'API ne sont pas couronnés de succès. Le serveur génère des exceptions si vos appels d'API échouent. Il est important de capturer les erreurs d'API et de les gérer de manière appropriée.
Une instance Google::Ads::GoogleAds::Errors::GoogleAdsError est générée lorsqu'une erreur d'API se produit. Il contient des informations qui vous aident à déterminer ce qui n'a pas fonctionné. Vous pouvez configurer une fonction d'assistance pour gérer les erreurs. Consultez un exemple de gestionnaire d'erreurs sur GitHub.