Logging aktivieren

Sie können Anfragen, Antworten und Zusammenfassungsnachrichten, die an die Google Ads API gesendet werden, entweder mit dem Standard-Logger in der Ruby-Clientbibliothek oder mit Ihrem eigenen benutzerdefinierten Ruby-Logger protokollieren. Wenn keine Logging-Konfiguration angegeben ist, ist das Logging standardmäßig deaktiviert.

Logebenen

Die Bibliothek protokolliert Ereignisse je nach Ergebnis der API-Anfrage auf verschiedenen Protokollebenen:

Konfiguration

Sie können das Logging in der Konfigurationsdatei google_ads_config.rb oder programmatisch zur Laufzeit konfigurieren.

Standard-Logger

Richten Sie den Standard-Logger ein, indem Sie die Felder log_level und log_target in der Datei google_ads_config.rb angeben:

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

Benutzerdefinierter Logger

Sie können auch eine eigene benutzerdefinierte Ruby-Logger-Instanz mit dem Feld logger angeben. Wenn Sie logger angeben, werden log_level und log_target ignoriert:

require 'logger'

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

Sie können auch einen benutzerdefinierten Logger zuweisen, nachdem Sie den Client mit client.logger= instanziiert haben. Beachten Sie, dass dies nur für Dienstclients gilt, die nach dem Festlegen von client.logger abgerufen (client.service.<name>) werden:

require 'logger'

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