يمكن تسجيل الطلبات والردود والرسائل التلخيصية التي يتم إرسالها إلى Google Ads API باستخدام أداة تسجيل مخصّصة أو أداة التسجيل التلقائية في مكتبة العميل للغة Perl.
مستويات السجلّ
ستسجِّل المكتبة أنواعًا مختلفة من الأحداث في مستويات سجلّات مختلفة. في حال تلقّي استجابة ناجحة من واجهة برمجة التطبيقات، سيتم تسجيل الملخّص في INFO، وسيتم تسجيل الطلبات والردود الكاملة في DEBUG. في حال حدوث خطأ في واجهة برمجة التطبيقات نتيجةً لطلب معيّن، سيتم تسجيل رسالة الملخّص في WARN وسيتم تسجيل الطلب بالكامل
والردّ في INFO.
| نوع السجلّ | اسم السجلّ | مستوى النجاح | مستوى الخطأ |
|---|---|---|---|
| الملخّص | Google.Ads.GoogleAds.Summary | معلومات | WARN |
| التفصيل | 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 مباشرةً للمزيد من
التحكّم في كيفية تسجيل الطلبات.