רישום

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

כברירת מחדל, הספרייה משתמשת ב-framework וביומנים המובנים של Python ב-Logging ב-stderr. אם כוללים את האובייקט logging שמוגדר בהגדרות, הוא מועבר ישירות אל logging.config.dictConfig בתור dict.

אפשר גם להגדיר רישום ביומן באופן פרוגרמטי על ידי הגדרת תצורה לרישום ביומן לפני שמאתחלים את הלקוח. אפשר לאחזר את המכונה של יומן הלקוח ולהגדיר אותה באמצעות הדוגמה הבאה:

import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)

לתשומת ליבכם: יומן הלקוח מוגדר כשמתבצע אתחול של הלקוח. המערכת תתעלם משינויים שיבוצעו בהמשך בהגדרות הרישום ביומן. כדי לשנות באופן פרוגרמטי את ההגדרות של הרישום ביומן בקובץ ה-YAML, חשוב להקפיד להפעיל את השורות שלמעלה לפני אתחול הלקוח.

רמות ביומן

הלקוח יוצר יומנים בכמה רמות שונות, ואתם יכולים לקבוע את ההגדרות כך שיוצגו חלק מהרמות הבאות או כולן:

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

מאחר ש-framework של רישום ביומן Python מתעלמת מהודעות יומן פחות חמורות מהרמה שהוגדרה, המשמעות של הגדרה ל-WARNING היא לראות רק הודעות תמציתיות שקשורות לבקשות שנכשלו, אבל אם מגדירים את הערך DEBUG, המשמעות היא שתראו את כל סוגי היומנים האפשריים בטבלה שלמעלה.

רישום ביומן לקובץ

אפשר להעביר הודעות ביומן ב-צינורות בקלות לקובץ. למשל, כשמריצים את הדוגמה get_campaigns:

python get_campaigns.py -c $CLIENT_ID 2> example.log

מיירטים לרישום יומנים

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