Logowanie

Żądania, odpowiedzi i komunikaty podsumowujące wysyłane do interfejsu Google Ads API można rejestrować za pomocą własnego niestandardowego loggera lub domyślnego loggera w bibliotece klienta dla języka Perl.

Poziomy logowania

Biblioteka rejestruje różne typy zdarzeń na różnych poziomach logowania. W przypadku udanej odpowiedzi interfejsu API podsumowanie jest rejestrowane w INFO, a pełne żądanie i odpowiedź są rejestrowane w DEBUG. W przypadku żądania, które powoduje błąd interfejsu API, komunikat podsumowujący jest rejestrowany na poziomie WARN, a pełne żądanie i odpowiedź są rejestrowane na poziomie INFO.

Typ logu	Nazwa logu	Poziom sukcesu	Poziom niepowodzenia
PODSUMOWANIE	Google.Ads.GoogleAds.Summary	INFORMACJE	WARN
SZCZEGÓŁY	Google.Ads.GoogleAds.Detail	DEBUGOWANIE	INFORMACJE

W przypadku częściowych niepowodzeń szczegóły są rejestrowane w obiekcie rejestrującym DETAIL na poziomie DEBUG.

Konfiguracja

Biblioteka klienta używa niestandardowej klasy do wszystkich celów związanych z logowaniem i jest udostępniana przez moduł GoogleAdsLogger. Ta klasa zapewnia domyślną konfigurację, w której zarówno logery podsumowania, jak i szczegółów zapisują dane w plikach w folderze logs w katalogu HOME.

Dostosowywanie konfiguracji Log4perl

Możesz zastąpić domyślną konfigurację, udostępniając niestandardowy plik log4perl.conf w katalogu HOME lub inicjując Log::Log4perl bezpośrednio w aplikacji przed wywołaniem interfejsu API.

Włączanie i wyłączanie logów

Logowanie można włączyć lub wyłączyć automatycznie za pomocą tych metod pomocniczych:

• Włącz logowanie dla obu loggerów (przekaż 1, aby ustawić poziom na DEBUG, dzięki czemu w przypadku udanych wywołań będą rejestrowane pełne ładunki żądań i odpowiedzi):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Wyłączanie całego logowania:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• Wyłączanie logowania podsumowania:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• Wyłącz szczegółowe logowanie:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

Możesz używać metod klasy GoogleAdsLogger bezpośrednio, aby mieć jeszcze większą kontrolę nad tym, jak żądania są rejestrowane.