רישום

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

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

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

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

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

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

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

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

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

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