ثبت

درخواست‌ها، پاسخ‌ها، و پیام‌های خلاصه ارائه‌شده به Google Ads API را می‌توان با ثبت‌کننده سفارشی خودتان یا ثبت‌کننده پیش‌فرض در کتابخانه مشتری برای Perl ثبت کرد.

سطوح گزارش

کتابخانه انواع مختلف رویدادها را در سطوح مختلف گزارش ثبت می‌کند. درصورت موفقیت‌آمیز بودن پاسخ میانای برنامه‌سازی کاربردی، خلاصه در INFO ثبت می‌شود و درخواست و پاسخ کامل در DEBUG ثبت می‌شود. در درخواستی که منجر به خطای API می‌شود، پیام خلاصه در WARN ثبت می‌شود و درخواست و پاسخ کامل در INFO ثبت می‌شود.

نوع گزارش	نام گزارش	سطح موفقیت	سطح خرابی
خلاصه	Google.Ads.GoogleAds.Summary	اطلاعات	هشدار
جزئیات	Google.Ads.GoogleAds.Detail	اشکال‌زدایی	اطلاعات

برای موارد ناقص ناموفق، جزئیات موارد ناقص ناموفق در ثبت‌کننده DETAIL در DEBUG ثبت می‌شود.

پیکربندی

کتابخانه مشتری از یک کلاس سفارشی برای همه اهداف ثبت گزارش استفاده می‌کند و ازطریق ماژول GoogleAdsLogger نمایش داده می‌شود. این کلاس پیکربندی پیش‌فرضی ارائه می‌دهد که در آن، هم ثبت‌کننده خلاصه و هم ثبت‌کننده جزئیات در فایل‌های موجود در پوشه logs در دایرکتوری HOME شما می‌نویسند.

سفارشی‌سازی پیکربندی Log4perl

می‌توانید پیکربندی پیش‌فرض را با ارائه فایل سفارشی log4perl.conf در فهرست راهنمای HOME یا با مقداردهی اولیه Log::Log4perl مستقیماً در برنامه‌تان قبل‌از برقراری تماس‌های میانای برنامه‌سازی کاربردی لغو کنید.

فعال یا غیرفعال کردن گزارش‌ها

ثبت گزارش را می‌توان بااستفاده از روش‌های کمکی زیر به‌صورت برنامه‌نویسی‌شده فعال یا غیرفعال کرد:

• گزارش‌گیری را برای هر دو گزارش‌گیر فعال کنید (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 استفاده کنید تا کنترل بیشتری بر نحوه ثبت درخواست‌ها داشته باشید.