Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Ads API'ye yapılan istekler, yanıtlar ve özet mesajlar, Perl için istemci kitaplığındaki kendi özel günlükçünüz veya varsayılan günlükçü ile günlüğe kaydedilebilir.
Günlük Kaydı Düzeyleri
Kitaplık, farklı etkinlik türlerini farklı günlük düzeylerine kaydeder. Başarılı bir API yanıtında özet INFO konumuna, tam istek ve yanıtlar ise DEBUG konumuna kaydedilir. API hatasıyla sonuçlanan bir istekte özet mesaj WARN konumuna, tam istek ve yanıt ise INFO konumuna kaydedilir.
Günlük türü
Günlük adı
Başarı düzeyi
Hata düzeyi
ÖZET
Google.Ads.GoogleAds.Summary
BİLGİ
WARN
AYRINTI
Google.Ads.GoogleAds.Detail
HATA AYIKLA
BİLGİ
Kısmi hatalar için kısmi hata ayrıntıları DEBUG adresine kaydedilir.
Yapılandırma
İstemci kitaplığı, tüm günlük kaydı amaçları için özel bir sınıf kullanır ve GoogleAdsLogger modülü aracılığıyla kullanıma sunulur. Bu sınıf, hem özet hem de ayrıntı kaydedicilerin HOME dizininizdeki logs klasöründe bulunan göreli dosyalara kaydedeceği varsayılan bir yapılandırma sağlar.
Ancak varsayılan yapılandırma, HOME dizininizde bir log4perl.conf dosyası sağlanarak geçersiz kılınabilir.
Günlük kaydı, aşağıdaki yöntemler kullanılarak etkinleştirilebilir/devre dışı bırakılabilir:
Her iki günlük kaydedici için de günlük kaydını etkinleştirir.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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."]]
