הפעלת רישום ביומן

אתם יכולים לתעד ביומן בקשות, תגובות והודעות סיכום שנשלחות ל-Google Ads API באמצעות כלי רישום ברירת המחדל ביומן בספריית הלקוח של Ruby, או באמצעות כלי רישום ביומן בהתאמה אישית של Ruby. אם לא מספקים הגדרות רישום ביומן, הרישום ביומן מושבת כברירת מחדל.

רמות הרישום ביומן

הספרייה מתעדת אירועים ברמות שונות של יומנים, בהתאם לתוצאה של בקשת ה-API:

סוג אירוע	רמת הרישום ביומן הסיכום	רמת הרישום ביומן של בקשות ותגובות מלאות
תגובה תקינה מה-API	INFO	DEBUG
שגיאת API	WARN	INFO
כשל חלקי	ללא	‫DEBUG (פרטים על כשל חלקי)

זהירות: ברמה DEBUG, היומנים מכילים את המטען הייעודי (payload) המלא של הבקשות והתגובות, שעשוי לכלול נתונים רגישים בחשבון וליצור נפח גדול של יומנים. השתמשו ב-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

כלי רישום בהתאמה אישית

אתם יכולים גם לציין מכונה מותאמת אישית של 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)