Włącz logowanie

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

Poziomy logowania

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

Typ zdarzenia Poziom logowania podsumowania Poziom logowania pełnego żądania i odpowiedzi
Prawidłowa 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 logger

Skonfiguruj domyślny logger, 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 moduł logujący

Możesz też określić własną instancję Ruby Logger, używając 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 logger po utworzeniu instancji klienta za pomocą client.logger=. Pamiętaj, że ta zmiana będzie obowiązywać tylko w przypadku klientów usługi pobranych (client.service.<name>) po ustawieniu client.logger:

require 'logger'

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