Logowanie

Żądania, odpowiedzi i komunikaty podsumowujące wysyłane do interfejsu Google Ads API mogą być rejestrowane za pomocą własnego niestandardowego rejestru lub domyślnego rejestru w bibliotece klienta dla języka Perl.

Poziomy logu

Biblioteka będzie rejestrować różne typy zdarzeń na różnych poziomach logów. Po pomyślnej odpowiedzi interfejsu API podsumowanie zostanie zarejestrowane INFO, a pełne żądanie i odpowiedzi będą logowane DEBUG. W przypadku żądania, które spowodowało błąd interfejsu API, wiadomość z podsumowaniem zostanie zarejestrowana w WARN, a pełne żądanie i odpowiedź – logowane INFO.

Typ logu Nazwa logu Poziom sukcesu Poziom niepowodzenia
PODSUMOWANIE Google.Ads.GoogleAds.Summary INFORMACJE OSTRZEŻ
SZCZEGÓŁY Google.Ads.GoogleAds.Detail DEBUGUJ INFORMACJE

W przypadku częściowych błędów szczegóły są rejestrowane na stronie DEBUG.

Konfiguracja

Biblioteka klienta używa klasy niestandardowej do wszystkich celów związanych z logowaniem i jest dostępna w module GoogleAdsLogger. Ta klasa udostępnia domyślną konfigurację, w której rejestratorzy podsumowania i rejestratory szczegółów będą logowali się do plików względnych w folderze logs w katalogu HOME. Konfigurację domyślną można jednak zastąpić, przesyłając plik log4perl.conf do katalogu HOME.

Logowanie można włączyć lub wyłączyć w jeden z tych sposobów:

  • Włącza logowanie w obu rejestratorach.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Wyłącza logowanie podsumowujące.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Wyłącza logowanie szczegółów.

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

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