ورود به سیستم
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
درخواست‌ها، پاسخ‌ها و پیام‌های خلاصه‌شده به Google Ads API را می‌توان با ثبت‌کننده سفارشی شما یا ثبت‌کننده پیش‌فرض در کتابخانه مشتری برای Perl ثبت کرد.
سطوح ورود به سیستم
کتابخانه انواع مختلفی از رویدادها را در سطوح مختلف گزارش ثبت می کند. در یک پاسخ موفق API، خلاصه در INFO ثبت می‌شود و درخواست و پاسخ‌های کامل در DEBUG ثبت می‌شود. در درخواستی که منجر به خطای API شود، پیام خلاصه در WARN و درخواست و پاسخ کامل در INFO ثبت می‌شود.
| نوع گزارش | نام لاگ | سطح موفقیت | سطح شکست |
|---|
| خلاصه | Google.Ads.GoogleAds.Summary | اطلاعات | هشدار |
| جزئیات | Google.Ads.GoogleAds.Detail | اشکال زدایی | اطلاعات |
برای خرابی های جزئی، جزئیات خرابی جزئی در DEBUG ثبت می شود.
پیکربندی
کتابخانه سرویس گیرنده از یک کلاس سفارشی برای همه اهداف گزارش استفاده می کند و از طریق ماژول GoogleAdsLogger در معرض دید قرار می گیرد. این کلاس یک پیکربندی پیش‌فرض را فراهم می‌کند که هم خلاصه‌نویس‌ها و هم جزئیات ثبت‌کننده‌ها به فایل‌های نسبی در پوشه logs زیر دایرکتوری HOME شما وارد می‌شوند. اما پیکربندی پیش فرض را می توان با ارائه یک فایل log4perl.conf در فهرست HOME خود لغو کرد.
ورود به سیستم را می توان با استفاده از روش های زیر فعال/غیرفعال کرد:
ورود به سیستم را برای هر دو لاگر فعال می کند.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
ثبت خلاصه را غیرفعال می کند.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
ثبت جزئیات را غیرفعال می کند.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
برای کنترل بیشتر بر نحوه ثبت درخواست‌ها، می‌توانید مستقیماً از روش‌های کلاس GoogleAdsLogger استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
