درخواست‌ها، پاسخ‌ها، و پیام‌های خلاصه ارسال‌شده به Google Ads API را می‌توان با ثبت‌کننده سفارشی خودتان یا ثبت‌کننده پیش‌فرض در کتابخانه مشتری برای Perl ثبت کرد.
سطوح گزارش
کتابخانه انواع مختلف رویدادها را در سطوح مختلف گزارش ثبت می‌کند. درصورت موفقیت‌آمیز بودن پاسخ میانای برنامه‌سازی کاربردی، خلاصه در INFO ثبت می‌شود و درخواست و پاسخ کامل در DEBUG ثبت می‌شود. در درخواستی که منجر به خطای
میانای برنامه‌سازی کاربردی می‌شود، پیام خلاصه در WARN و درخواست کامل
و پاسخ در INFO ثبت می‌شود.
| نوع گزارش | نام گزارش | سطح موفقیت | سطح خرابی |
|---|---|---|---|
| خلاصه | Google.Ads.GoogleAds.Summary | اطلاعات | هشدار |
| جزئیات | Google.Ads.GoogleAds.Detail | اشکال‌زدایی | اطلاعات |
برای موارد ناقص ناموفق، جزئیات مورد ناقص ناموفق در DETAIL
گزارشگر در DEBUG ثبت می‌شود.
پیکربندی
کتابخانه مشتری از یک کلاس سفارشی برای همه اهداف ثبت گزارش استفاده می‌کند و ازطریق
ماژول GoogleAdsLogger نمایش داده می‌شود. این کلاس پیکربندی پیش‌فرضی ارائه می‌دهد که در آن هم گزارشگرهای خلاصه و هم گزارشگرهای جزئیات در فایل‌های موجود در پوشه logs در زیر دایرکتوری HOME شما می‌نویسند.
سفارشی‌سازی پیکربندی Log4perl
می‌توانید پیکربندی پیش‌فرض را با ارائه فایل log4perl.conf سفارشی در فهرست راهنمای HOME یا با مقداردهی اولیه Log::Log4perl مستقیماً در برنامه‌تان قبل‌از برقراری تماس‌های API لغو کنید.
فعال یا غیرفعال کردن گزارش‌ها
گزارش‌گیری را می‌توان بااستفاده از روش‌های کمکی زیر به‌صورت برنامه‌نویسی فعال یا غیرفعال کرد:
گزارش‌گیری را برای هر دو گزارشگر فعال کنید (
1را ارسال کنید تا سطح را رویDEBUGتنظیم کنید تا بار کامل درخواست و پاسخ برای تماس‌های موفق گزارش شود):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);غیرفعال کردن همه گزارش‌گیری‌ها:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();غیرفعال کردن گزارش خلاصه:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();غیرفعال کردن گزارش‌گیری با جزئیات:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
برای کنترل بیشتر بر نحوه ثبت درخواست‌ها، می‌توانید مستقیماً از روش‌های کلاس GoogleAdsLogger استفاده کنید.