يمكن تسجيل الطلبات والردود والرسائل الملخّصة التي يتم إرسالها إلى Google Ads API باستخدام مسجِّل مخصّص أو المسجِّل التلقائي في مكتبة العميل للغة Perl.
مستويات التسجيل
تسجِّل المكتبة أنواعًا مختلفة من الأحداث في مستويات تسجيل مختلفة. عند تلقّي ردّ ناجح من واجهة برمجة التطبيقات، يتم تسجيل الملخّص على مستوى INFO، ويتم تسجيل الطلب والردّ الكاملَين على مستوى DEBUG. في حال تعذّر إرسال طلب بسبب
خطأ في واجهة برمجة التطبيقات، يتم تسجيل الرسالة الملخّصة على مستوى WARN، ويتم تسجيل الطلب والردّ الكاملَين
على مستوى INFO.
| نوع السجلّ | اسم السجلّ | مستوى النجاح | مستوى الخطأ |
|---|---|---|---|
| الملخّص | Google.Ads.GoogleAds.Summary | معلومات | تحذير |
| التفصيل | Google.Ads.GoogleAds.Detail | تصحيح الأخطاء | معلومات |
في حالات الإخفاق الجزئي، يتم تسجيل تفاصيل الإخفاق الجزئي في DETAIL
مسجِّل على DEBUG.
التهيئة
تستخدِم مكتبة العميل فئة مخصّصة لجميع أغراض التسجيل، ويتم عرضها
من خلال الوحدة GoogleAdsLogger. توفّر هذه الفئة إعدادًا تلقائيًا يكتب فيه كلّ من مسجِّلات الملخّص والتفاصيل في ملفات في مجلد logs ضمن دليل HOME.
تخصيص إعدادات Log4perl
يمكنك إلغاء الإعدادات التلقائية من خلال توفير ملف مخصّص
log4perl.conf في دليل HOME، أو من خلال
تهيئة Log::Log4perl مباشرةً في تطبيقك قبل إجراء طلبات البيانات من واجهة برمجة التطبيقات.
تفعيل السجلات أو إيقافها
يمكن تفعيل التسجيل أو إيقافه آليًا باستخدام الطرق المساعدة التالية:
تفعيل التسجيل لكلا المسجِّلَين (مرِّر
1لضبط المستوى علىDEBUGحتى يتم تسجيل حمولات الطلبات والردود الكاملة للطلبات الناجحة):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);إيقاف جميع عمليات التسجيل:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();إيقاف تسجيل الملخّص:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();إيقاف تسجيل التفاصيل:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
يمكنك استخدام طرق فئة GoogleAdsLogger مباشرةً للتحكّم بشكلٍ أكبر في كيفية تسجيل الطلبات.