Włącz logowanie

Żądania, odpowiedzi i wiadomości podsumowujące wysyłane do interfejsu Google Ads API możesz rejestrować za pomocą domyślnego rejestratora w bibliotece klienta Ruby lub własnego niestandardowego rejestratora Ruby. Jeśli nie podasz konfiguracji logowania, logowanie będzie domyślnie wyłączone.

Poziomy logowania

Biblioteka rejestruje zdarzenia na różnych poziomach dziennika w zależności od wyniku żądania do interfejsu API:

Typ zdarzenia Poziom logowania podsumowania Poziom logowania pełnych żądań i odpowiedzi
Udana odpowiedź interfejsu API INFO DEBUG
Błąd interfejsu API WARN INFO
Częściowe niepowodzenie Brak DEBUG (szczegóły częściowego niepowodzenia)

Konfiguracja

Logowanie możesz skonfigurować w pliku konfiguracji google_ads_config.rb lub programowo w czasie działania.

Domyślny rejestrator

Skonfiguruj domyślny rejestrator, określając pola log_level i log_target w pliku 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

Niestandardowy rejestrator

Możesz też określić własną instancję Ruby Logger za pomocą pola logger. Jeśli określisz logger, parametry log_level i log_target zostaną zignorowane:

require 'logger'

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

Możesz też przypisać niestandardowy rejestrator po utworzeniu instancji klienta za pomocą funkcji client.logger=. Pamiętaj, że ma to wpływ tylko na klientów usług pobranychclient.service.<name> po ustawieniu wartości client.logger:

require 'logger'

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