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