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