التسجيل

يمكن تسجيل الطلبات والردود ورسائل الملخّص التي يتم إرسالها إلى Google Ads API باستخدام أداة التسجيل المخصّصة أو أداة التسجيل التلقائية في مكتبة العميل للغة Perl.

مستويات السجلّ

تسجّل المكتبة أنواعًا مختلفة من الأحداث في مستويات سجلّ مختلفة. عند تلقّي استجابة ناجحة من واجهة برمجة التطبيقات، يتم تسجيل الملخّص في INFO، ويتم تسجيل الطلب والاستجابة الكاملَين في DEBUG. في الطلب الذي يؤدي إلى حدوث خطأ في واجهة برمجة التطبيقات، يتم تسجيل رسالة الملخّص في WARN، ويتم تسجيل الطلب والردّ الكاملَين في INFO.

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الخطأ
الملخّص	Google.Ads.GoogleAds.Summary	معلومات	WARN
التفصيل	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 مباشرةً للتحكّم بشكل أكبر في كيفية تسجيل الطلبات.