Logowanie

Żądania, odpowiedzi i wiadomości podsumowujące wysyłane do interfejsu Google Ads API można rejestrować za pomocą własnego rejestratora niestandardowego lub domyślnego rejestratora w bibliotece klienta dla Perla.

Poziomy logowania

Biblioteka rejestruje różne typy zdarzeń na różnych poziomach dziennika. W przypadku udanej odpowiedzi interfejsu API podsumowanie jest rejestrowane w INFO, a pełne żądanie i odpowiedź – 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 błędu
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 DETAILloggerze na poziomie DEBUG.

Konfiguracja

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

Dostosowywanie konfiguracji Log4perl

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

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

Logowanie można włączać i wyłączać programowo za pomocą tych metod pomocniczych:

• Włącz logowanie dla obu rejestratorów (przekaż 1, aby ustawić poziom na DEBUG, tak aby w przypadku udanych wywołań rejestrowane były pełne ładunki żądań i odpowiedzi):

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

• Wyłącz wszystkie logi:

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

• Wyłącz logowanie podsumowań:

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

• Wyłącz szczegółowe logowanie:

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

Możesz bezpośrednio używać metod klasy GoogleAdsLogger, aby mieć jeszcze większą kontrolę nad rejestrowaniem żądań.