רישום

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

רמות יומן

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

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

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

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

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

רכיבי יירוט לצורך רישום ביומן

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