लाइब्रेरी को कॉन्फ़िगर करके, Google Ads API के साथ इंटरैक्शन को अलग-अलग तरीकों से लॉग किया जा सकता है. ज़्यादा जानकारी वाले अनुरोधों और जवाबों के साथ-साथ, कम शब्दों में जानकारी देने वाले मैसेज भी लॉग किए जा सकते हैं. इन सेटिंग को क्लाइंट लाइब्रेरी के कॉन्फ़िगरेशन से मैनेज किया जाता है. यहां अलग-अलग तरह के कॉन्फ़िगरेशन विकल्पों के बारे में जानकारी दी गई है.
यह लाइब्रेरी, Python के पहले से मौजूद लॉगिंग फ़्रेमवर्क का इस्तेमाल करती है और डिफ़ॉल्ट रूप से stderr में लॉग करती है. अगर इसे शामिल किया जाता है, तो आपके कॉन्फ़िगरेशन में तय किए गए logging ऑब्जेक्ट को सीधे तौर पर dict के तौर पर logging.config.dictConfig को भेजा जाता है.
क्लाइंट को शुरू करने से पहले, लॉगिंग कॉन्फ़िगरेशन सेट करके, प्रोग्राम के हिसाब से भी लॉगिंग को कॉन्फ़िगर किया जा सकता है. क्लाइंट लॉगर इंस्टेंस को वापस पाया जा सकता है और इसे नीचे दिए गए उदाहरण की मदद से कॉन्फ़िगर किया जा सकता है:
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 इंटरसेप्टर्स बनाकर, अपनी पसंद के मुताबिक लॉगिंग सेट अप की जा सकती है. ज़्यादा जानकारी और कस्टम लॉगिंग इंटरसेप्टर का उदाहरण पाने के लिए, लॉगिंग के बारे में गाइड देखें.