אפשר לתעד בקשות, תגובות והודעות סיכום שנשלחות ל-Google Ads API באמצעות כלי רישום ביומן בהתאמה אישית או כלי הרישום ביומן שמוגדר כברירת מחדל בספריית הלקוח של Perl.
רמות הרישום ביומן
הספרייה רושמת סוגים שונים של אירועים ברמות שונות של יומנים. בתגובה מה-API מוצלחת, הסיכום מתועד ברמה INFO, והבקשה והתגובה המלאות מתועדות ברמה DEBUG. בבקשה שגורמת לשגיאת API, הודעת הסיכום מתועדת ב-WARN והבקשה והתגובה המלאות מתועדות ב-INFO.
| סוג יומן הביקורת | שם יומן הביקורת | רמת ההצלחה | רמת הכשל |
|---|---|---|---|
| סיכום | Google.Ads.GoogleAds.Summary | מידע | אזהרה |
| פרטים | Google.Ads.GoogleAds.Detail | ניפוי באגים | מידע |
במקרה של כשלים חלקיים, פרטי הכשל החלקי נרשמים ביומן DETAIL ברמה 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.