فعال‌سازی گزارش‌گیری

می‌توانید درخواست‌ها، پاسخ‌ها، و پیام‌های خلاصه ارسال‌شده به Google Ads API را بااستفاده از گزارشگر پیش‌فرض در کتابخانه مشتری Ruby یا گزارشگر Ruby سفارشی خودتان گزارش کنید. اگر پیکربندی گزارش‌گیری ارائه نشود، گزارش‌گیری به‌طور پیش‌فرض غیرفعال می‌شود.

سطوح گزارش

کتابخانه رویدادها را در سطوح مختلف گزارش براساس نتیجه درخواست API ثبت می‌کند:

نوع رویداد	سطح گزارش خلاصه	سطح گزارش کامل درخواست و پاسخ
پاسخ موفق میانای برنامه‌سازی کاربردی	INFO	DEBUG
خطای میانای برنامه‌سازی کاربردی	WARN	INFO
خرابی جزئی	خالی	‫DEBUG (جزئیات عدم موفقیت جزئی)

احتیاط: در سطح DEBUG، گزارش‌های ورود حاوی درخواست کامل و پاسخ بارها است که ممکن است شامل داده‌های حساس حساب باشد و حجم زیادی از گزارش‌های ورود را تولید کند. از DEBUG فقط برای عیب‌یابی محلی استفاده کنید و DEBUG گزارش‌گیری را در محیط‌های تولید فعال نگذارید.

پیکربندی

می‌توانید گزارش‌گیری را در 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

گزارشگر سفارشی

همچنین می‌توانید نمونه Logger Ruby سفارشی خودتان را بااستفاده از فیلد 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.logger واکشی شده‌اند (client.service.<name>) اعمال می‌شود:

require 'logger'

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