רישום ביומן

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

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

הספרייה רושמת סוגים שונים של אירועים ברמות שונות של יומנים. אם התגובה של ה-API תקינה, הסיכום מתועד ברמה INFO, והבקשה והתגובה המלאות מתועדות ברמה DEBUG. בבקשה שגורמת לשגיאת API, הודעת הסיכום מתועדת ב-WARN והבקשה והתגובה המלאות מתועדות ב-INFO.

סוג יומן הביקורת	שם יומן הביקורת	רמת ההצלחה	רמת הכשל
סיכום	Google.Ads.GoogleAds.Summary	מידע	WARN
פרטים	Google.Ads.GoogleAds.Detail	ניפוי באגים	מידע

במקרה של כשלים חלקיים, פרטי הכשל החלקי נרשמים ביומן של DETAIL logger בכתובת DEBUG.

הגדרות אישיות

ספריית הלקוח משתמשת במחלקה מותאמת אישית לכל מטרות הרישום ביומן, והיא נחשפת דרך המודול GoogleAdsLogger. המחלקת הזו מספקת הגדרת ברירת מחדל שבה גם סיכום וגם פרטים של כלי הרישום נכתבים לקבצים בתיקייה logs מתחת לתיקייה HOME.

התאמה אישית של ההגדרה של Log4perl

אפשר לבטל את הגדרת ברירת המחדל על ידי הוספת קובץ log4perl.conf בהתאמה אישית לתיקייה HOME, או על ידי הפעלה של Log::Log4perl ישירות באפליקציה לפני ביצוע קריאות ל-API.

הפעלה או השבתה של יומנים

אפשר להפעיל או להשבית את הרישום ביומן באופן פרוגרמטי באמצעות שיטות העזר הבאות:

• מפעילים רישום ביומן לשני רכיבי הרישום (מעבירים את הערך 1 כדי להגדיר את הרמה ל-DEBUG, כך שמטען הייעודי (payload) של הבקשה והתגובה יירשם ביומן עבור שיחות מוצלחות):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• השבתת כל הרישום ביומן:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• השבתת הרישום ביומן של הסיכומים:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

• משביתים את הרישום המפורט ביומן:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
  

אפשר להשתמש ישירות בשיטות של המחלקה GoogleAdsLogger כדי לקבל שליטה רבה יותר על אופן הרישום של הבקשות ביומן.