تفعيل التسجيل

يمكنك تسجيل الطلبات والردود ورسائل الملخّصات المُرسَلة إلى Google Ads API باستخدام إما أداة التسجيل التلقائية في مكتبة Ruby أو أداة تسجيل Ruby المخصّصة. في حال عدم توفير إعدادات التسجيل، يتم إيقاف التسجيل تلقائيًا.

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

تسجّل المكتبة الأحداث على مستويات مختلفة من السجلّات استنادًا إلى نتيجة طلب بيانات من واجهة برمجة التطبيقات:

التهيئة

يمكنك ضبط التسجيل في ملف الإعداد google_ads_config.rb أو آليًا في وقت التشغيل.

المسجِّل التلقائي

اضبط أداة التسجيل التلقائية من خلال تحديد الحقلَين log_level وlog_target في ملف google_ads_config.rb:

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

أداة تسجيل مخصّصة

يمكنك أيضًا تحديد مثيل Ruby Logger المخصّص باستخدام الحقل logger. في حال تحديد logger، يتم تجاهل log_level وlog_target:

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

يمكنك أيضًا تعيين مسجّل مخصّص بعد إنشاء مثيل للعميل باستخدام client.logger=. يُرجى العِلم أنّ هذا الإجراء لا يسري إلا على برامج الخدمة التي تم جلبها (client.service.<name>) بعد ضبط client.logger:

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)