Żą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 rejestrowania
Biblioteka będzie rejestrować różne typy zdarzeń na różnych poziomach dziennika. W przypadku pomyślnej odpowiedzi interfejsu API podsumowanie zostanie zarejestrowane w INFO, a pełne żądanie i odpowiedzi – w DEBUG. W przypadku żądania, które spowodowało błąd interfejsu API, komunikat podsumowujący zostanie zarejestrowany na poziomie WARN, a pełne żądanie i odpowiedź – 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 | DEBUGUJ | INFORMACJE |
W przypadku częściowych niepowodzeń szczegóły częściowego niepowodzenia zostaną zarejestrowane w 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 rejestratory podsumowujące, jak i szczegółowe będą rejestrować dane w plikach względnych w folderze logs w katalogu HOME.
Domyślną konfigurację można jednak zastąpić, podając plik log4perl.conf w katalogu HOME.
Logowanie można włączyć lub wyłączyć za pomocą tych metod:
Włącza logowanie w obu rejestratorach.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();Wyłącza rejestrowanie podsumowania.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Wyłącza szczegółowe rejestrowanie.
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ń.