רישום

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

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