Żą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.