التسجيل

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