Żądania, odpowiedzi i wiadomości z podsumowaniem wysyłane do interfejsu Google Ads API mogą być rejestrowane za pomocą własnego niestandardowego rejestratora lub domyślnego rejestrującego w bibliotece klienta języka Perl.
Poziomy rejestrowania
Biblioteka rejestruje różne typy zdarzeń na różnych poziomach rejestrowania. W przypadku pomyślnej odpowiedzi interfejsu API podsumowanie zostanie zarejestrowane INFO
, a pełne żądanie i odpowiedzi – DEBUG
. W przypadku żądania, które spowodowało błąd interfejsu API, komunikat z podsumowaniem zostanie zarejestrowany WARN
, a pełne żądanie i odpowiedź – INFO
.
Typ logu | Nazwa logu | Poziom sukcesu | Poziom błędów |
---|---|---|---|
PODSUMOWANIE | Google.Ads.GoogleAds.Summary | INFORMACJE | UWAGA |
SZCZEGÓŁY | Google.Ads.GoogleAds.Detail | DEBUGUJ | INFORMACJE |
W przypadku częściowych błędów szczegóły częściowych błędów są rejestrowane w DEBUG
.
Konfiguracja
Biblioteka klienta korzysta z klasy niestandardowej do wszystkich celów logowania i jest udostępniana w module GoogleAdsLogger. Ta klasa zawiera domyślną konfigurację, która jest używana zarówno przez rejestratorów podsumowania, jak i do plików względnych znajdujących się w folderze logs
w katalogu HOME
.
Konfigurację domyślną można jednak zastąpić, umieszczając plik log4perl.conf w katalogu HOME
.
Logowanie można włączyć lub wyłączyć w ten sposób:
Włącza logowanie dla obu rejestratorów.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
Wyłącza logowanie podsumowania.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
Wyłącza logowanie szczegółów.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Aby uzyskać jeszcze większą kontrolę nad sposobem logowania żądań, możesz używać bezpośrednio metod klasy GoogleAdsLogger
.