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