التسجيل

يمكن تسجيل الطلبات والردود ورسائل الملخّصات التي يتم إرسالها إلى Google Ads API باستخدام أداة التسجيل المخصّصة أو أداة التسجيل التلقائية في مكتبة العميل للغة Perl.

مستويات السجلّ

تسجّل المكتبة أنواعًا مختلفة من الأحداث في مستويات سجلّ مختلفة. عند تلقّي ردّ ناجح من واجهة برمجة التطبيقات، يتم تسجيل الملخّص في INFO، ويتم تسجيل الطلب والردّ الكاملَين في DEBUG. في حال حدوث خطأ في واجهة برمجة التطبيقات عند إرسال طلب، يتم تسجيل رسالة الملخّص في WARN ويتم تسجيل الطلب والردّ الكاملَين في INFO.

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الخطأ
الملخّص	Google.Ads.GoogleAds.Summary	معلومات	WARN
التفصيل	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 مباشرةً لمزيد من التحكّم في كيفية تسجيل الطلبات.