التسجيل

يمكن تسجيل الطلبات والردود ورسائل الملخّص المرسَلة إلى 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 مباشرةً للتحكّم بشكل أكبر في كيفية تسجيل الطلبات.