Żą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)