L'utilisation de base de la bibliothèque cliente est la suivante :
Installation
Nous vous recommandons d'utiliser bundler pour l'installation. Ajoutez une ligne à votre fichier Gemfile (en remplaçant x.y.z par le numéro de version qui vous intéresse) :
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 verrouillant la version exacte du gem et toutes les dépendances du gem qui ont été installées. L'opérateur de version pessimiste "~> x.y.z" n'autorise bundle update à installer que les nouvelles versions de la série x.y.*. Vous devez donc activer manuellement les nouvelles versions en mettant à jour à nouveau 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 gem :
terminal $ [sudo] gem install google-ads-googleads - Téléchargez le gem depuis la page des versions et installez-le à partir du fichier local :
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Configurer l'authentification
Pour authentifier vos appels d'API, suivez les instructions de la page Authentification et autorisation.
Utilisation
Pour inclure le gem dans votre code :
require 'google/ads/google_ads'
Pour extraire un service spécifique, par exemple CampaignService :
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Consultez les exemples sur GitHub pour obtenir des démonstrations plus détaillées sur l'utilisation de la bibliothèque.
Une fois que vous vous êtes familiarisé avec les exemples, nous vous recommandons également de vous familiariser avec 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 forcément réussis. Le serveur peut générer des erreurs si vos appels d'API échouent pour une raison quelconque. Il est important de capturer les erreurs d'API et de les gérer de manière appropriée.
Une instance GoogleAdsException est générée lorsqu'une erreur d'API se produit. Il contient des informations qui vous aideront à comprendre ce qui s'est mal passé. Vous pouvez également configurer une fonction d'assistance pour gérer les erreurs. Consultez un exemple de gestionnaire d'erreurs sur GitHub.