רישום

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

רמות יומן

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

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

במקרה של כשלים חלקיים, פרטי הכשל החלקי יירשמו ביומן ב-DEBUG.

תצורה

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

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

  • הפעלת הרישום ביומן בשני המודולים.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • השבתת הרישום ביומן של הסיכום.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • השבתת הרישום ביומן של הפרטים.

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

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