Abilita il logging

Puoi registrare richieste, risposte e messaggi di riepilogo inviati all'API Google Ads utilizzando il logger predefinito nella libreria client Ruby o il tuo logger Ruby personalizzato. Se non viene fornita alcuna configurazione di logging, il logging viene disattivato per impostazione predefinita.

Livelli di log

La libreria registra gli eventi a diversi livelli di log a seconda dell'esito della richiesta API:

Tipo di evento Livello log di riepilogo Livello di log completo di richieste e risposte
Risposta API riuscita INFO DEBUG
Errore API WARN INFO
Errore parziale Nessuno DEBUG (dettagli dell'errore parziale)

Configurazione

Puoi configurare la registrazione nel file di configurazione google_ads_config.rb o a livello di programmazione in fase di runtime.

Logger predefinito

Configura il logger predefinito specificando i campi log_level e log_target nel file 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

Logger personalizzato

Puoi anche specificare la tua istanza Ruby Logger personalizzata utilizzando il campo logger. Se specifichi logger, log_level e log_target vengono ignorati:

require 'logger'

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

Puoi anche assegnare un logger personalizzato dopo aver creato un'istanza del client utilizzando client.logger=. Tieni presente che questa operazione ha effetto solo sui service client recuperati (client.service.<name>) dopo l'impostazione di client.logger:

require 'logger'

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