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)