التسجيل

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