Logowanie

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

Poziomy rejestrowania

Biblioteka rejestruje różne typy zdarzeń na różnych poziomach rejestrowania. W przypadku udanej odpowiedzi interfejsu API podsumowanie jest rejestrowane na poziomie INFO, a pełne żądanie i odpowiedź – na poziomie DEBUG. W przypadku żądania, które powoduje błąd interfejsu API, wiadomość podsumowująca jest rejestrowana na poziomie WARN, a pełne żądanie i odpowiedź – na poziomie INFO.

Typ logu	Nazwa logu	Poziom powodzenia	Poziom niepowodzenia
PODSUMOWANIE	Google.Ads.GoogleAds.Summary	INFORMACJE	OSTRZEŻENIE
SZCZEGÓŁY	Google.Ads.GoogleAds.Detail	DEBUGOWANIE	INFORMACJE

W przypadku częściowych niepowodzeń szczegóły częściowego niepowodzenia są rejestrowane w rejestratorze DETAIL na poziomie DEBUG.

Konfiguracja

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

Dostosowywanie konfiguracji Log4perl

Możesz zastąpić konfigurację domyślną, podając niestandardowy log4perl.conf plik 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

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

• Włącz rejestrowanie w obu rejestratorach (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 rejestrowanie podsumowań:

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

• Wyłącz rejestrowanie szczegółów:

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

Aby mieć jeszcze większą kontrolę nad sposobem rejestrowania żądań, możesz bezpośrednio używać metod klasy GoogleAdsLogger.