Google Ads API को भेजे गए अनुरोधों, जवाबों, और खास जानकारी वाले मैसेज को लॉग किया जा सकता है. इसके लिए, Ruby क्लाइंट लाइब्रेरी में मौजूद डिफ़ॉल्ट लॉगर या Ruby के लिए बनाए गए अपने कस्टम लॉगर का इस्तेमाल करें. अगर लॉगिंग कॉन्फ़िगरेशन नहीं दिया जाता है, तो लॉगिंग डिफ़ॉल्ट रूप से बंद रहती है.
लॉग लेवल
एपीआई अनुरोध के नतीजे के आधार पर, लाइब्रेरी अलग-अलग लॉग लेवल पर इवेंट लॉग करती है:
| इवेंट किस तरह का है | खास जानकारी वाले लॉग का लेवल | अनुरोध और जवाब का पूरा लॉग लेवल |
|---|---|---|
| एपीआई से मिली जानकारी | INFO |
DEBUG |
| एपीआई से जुड़ी गड़बड़ी | WARN |
INFO |
| कुछ हद तक फ़ेल होना | कोई नहीं | DEBUG (कुछ फ़ाइलों का फ़ॉर्मैट नहीं बदला जा सका) |
कॉन्फ़िगरेशन
लॉगिंग को अपनी google_ads_config.rb कॉन्फ़िगरेशन फ़ाइल में या रनटाइम के दौरान प्रोग्राम के हिसाब से कॉन्फ़िगर किया जा सकता है.
डिफ़ॉल्ट लॉगर
अपनी google_ads_config.rb फ़ाइल में log_level और log_target फ़ील्ड की जानकारी देकर, डिफ़ॉल्ट लॉगर सेट अप करें:
Google::Ads::GoogleAds::Config.new do |c|
# Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
c.log_level = 'INFO'
# Output destination, such as STDOUT, STDERR, or a file path
c.log_target = STDOUT
end
कस्टम लॉगर
logger फ़ील्ड का इस्तेमाल करके, अपनी पसंद के मुताबिक Ruby Logger इंस्टेंस भी तय किया जा सकता है. अगर आपने logger की वैल्यू तय की है, तो log_level और log_target की वैल्यू को अनदेखा कर दिया जाता है:
require 'logger'
# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
c.logger = Logger.new('log/google_ads.log')
end
client.logger= का इस्तेमाल करके क्लाइंट को इंस्टैंशिएट करने के बाद, कस्टम लॉगर भी असाइन किया जा सकता है. ध्यान दें कि यह सिर्फ़ उन सेवा क्लाइंट पर लागू होता है जिन्हें client.logger सेट होने के बाद फ़ेच (client.service.<name>) किया गया है:
require 'logger'
client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)