Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Żą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:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 UTC."],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
