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