Activer la journalisation

Vous pouvez consigner les requêtes, les réponses et les messages récapitulatifs envoyés à l'API Google Ads à l'aide du journaliseur par défaut de la bibliothèque cliente Ruby ou de votre propre journaliseur Ruby personnalisé. Si aucune configuration de journalisation n'est fournie, la journalisation est désactivée par défaut.

Niveaux de journalisation

La bibliothèque enregistre les événements à différents niveaux de journalisation en fonction du résultat de la requête API :

Configuration

Vous pouvez configurer la journalisation dans votre fichier de configuration google_ads_config.rb ou de manière programmatique au moment de l'exécution.

Enregistreur par défaut

Configurez le journaliseur par défaut en spécifiant les champs log_level et log_target dans votre fichier google_ads_config.rb :

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

Enregistreur personnalisé

Vous pouvez également spécifier votre propre instance Logger Ruby personnalisée à l'aide du champ logger. Si vous spécifiez logger, log_level et log_target sont ignorés :

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

Vous pouvez également attribuer un enregistreur personnalisé après avoir instancié le client à l'aide de client.logger=. Notez que cela ne prend effet que sur les clients de service récupérés (client.service.<name>) après la définition de client.logger :

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)