می‌توانید درخواست‌ها، پاسخ‌ها، و پیام‌های خلاصه‌ای را که به Google Ads API ارسال شده‌اند بااستفاده از ثبت‌کننده پیش‌فرض در کتابخانه مشتری Ruby یا ثبت‌کننده Ruby سفارشی خودتان ثبت کنید. اگر پیکربندی ثبت گزارش ارائه نشود، ثبت گزارش به‌طور پیش‌فرض غیرفعال است.
سطوح گزارش
کتابخانه رویدادها را در سطوح مختلف گزارش بسته به نتیجه درخواست API ثبت می‌کند:
| نوع رویداد | سطح گزارش خلاصه | سطح گزارش کامل درخواست و پاسخ |
|---|---|---|
| پاسخ موفقیت‌آمیز میانای برنامه‌سازی کاربردی | INFO |
DEBUG |
| خطای میانای برنامه‌سازی کاربردی | WARN |
INFO |
| ناموفق جزئی | هیچ‌کدام | 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
ثبت‌کننده سفارشی
همچنین می‌توانید نمونه 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)