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

يمكنك تسجيل الطلبات والردود ورسائل الملخّص التي يتم إرسالها إلى 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)