جارٍ التسجيل

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

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

وستسجّل المكتبة أنواعًا مختلفة من الأحداث في مستويات سجلّ مختلفة. وعند تلقّي استجابة ناجحة من واجهة برمجة التطبيقات، سيتم تسجيل الملخّص على INFO، وسيتم تسجيل الطلب والردود الكاملة في DEBUG. في حال تقديم طلب نتج عنه خطأ في واجهة برمجة التطبيقات، سيتم تسجيل رسالة الملخص على 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 مباشرةً لمزيد من التحكّم في كيفية تسجيل الطلبات.