कॉन्फ़िगरेशन

Config क्लास का इस्तेमाल करके कॉन्फ़िगरेशन किया जाता है. इस क्लास को कई तरीकों से ऐक्सेस किया जा सकता है, जैसे कि कॉन्फ़िगरेशन फ़ाइल लिखना, बनाने के लिए वैल्यू तय करना या एनवायरमेंट वैरिएबल से वैल्यू लोड करना.

कॉन्फ़िगरेशन फ़ाइल

क्लाइंट को इंस्टैंशिएट करते समय, google_ads_config.rb फ़ाइल इस्तेमाल की जा सकती है.

अगर इंस्टैंशिएट करते समय कोई आर्ग्युमेंट इस्तेमाल नहीं किया जाता है, तो:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

इसके बाद, लाइब्रेरी GOOGLE_ADS_CONFIGURATION_FILE_PATH एनवायरमेंट वैरिएबल में दी गई जगह पर दिखेगी. अगर वह वैरिएबल सेट नहीं है, तो लाइब्रेरी, फ़ाइल के लिए आपकी HOME डायरेक्ट्री में दिखेगी.

वैकल्पिक रूप से, आपके पास कोई पाथ डालने का विकल्प भी है:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

इस स्थिति में, क्लाइंट उस फ़ाइलपाथ पर फ़ाइल खोजेगा.

इस फ़ाइल को जनरेट करने का सबसे आसान तरीका, GitHub की रिपॉज़िटरी से google_ads_config.rb को कॉपी करना है. इसके बाद, इसमें बदलाव करके रीफ़्रेश टोकन, क्लाइंट आईडी, और क्लाइंट सीक्रेट को शामिल करना है.

डाइनैमिक कॉन्फ़िगरेशन

लाइब्रेरी को इंस्टैंशिएट करते समय, डाइनैमिक तौर पर कॉन्फ़िगरेशन सेट अप किया जा सकता है. ऐसा तब भी किया जा सकता है, जब:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

इंस्टैंशिएट करने के बाद भी, कॉन्फ़िगरेशन में बदलाव किया जा सकता है:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

कॉन्फ़िगरेशन फ़ील्ड

Config ऑब्जेक्ट, इन फ़ील्ड के साथ काम करता है.

सामान्य फ़ील्ड:

• refresh_token: आपका OAuth रीफ़्रेश टोकन.
• client_id: आपका OAuth क्लाइंट आईडी.
• client_secret: आपका OAuth क्लाइंट सीक्रेट.
• developer_token: एपीआई ऐक्सेस करने के लिए आपका डेवलपर टोकन.
• login_customer_id: लॉगिन-ग्राहक-आईडी दस्तावेज़ देखें.

फ़ील्ड लॉग करना. पूरी जानकारी के लिए, लॉग करने की गाइड देखें.

• log_level: आपको जितने कम से कम लॉग लेवल मैसेज लॉग करने हैं. उदाहरण के लिए, 'DEBUG' के बारे में बताने से यह पक्का होगा कि आपको सभी लॉग मैसेज दिखें और 'INFO' तय करने से DEBUG मैसेज शामिल नहीं होंगे, लेकिन बाकी सभी मैसेज दिखेंगे.
• log_target: जहां आपको लॉग इन करना है, जैसे कि STDERR.
• logger: अपना कस्टम लॉगर तय करें. इसे तय करने से, log_level और log_target, दोनों बदल जाएंगे.

एनवायरमेंट वैरिएबल

एनवायरमेंट वैरिएबल का इस्तेमाल करके, क्लाइंट लाइब्रेरी को कॉन्फ़िगर किया जा सकता है. इन्हें डिफ़ॉल्ट रूप से लोड नहीं किया जाता. इन्हें लोड करने के लिए, क्लाइंट को इंस्टैंशिएट करने के बाद, एक और कॉल की ज़रूरत होती है. सभी भाषाओं में काम करने वाले एनवायरमेंट वैरिएबल की पूरी सूची देखें.

अपने Config में एनवायरमेंट वैरिएबल लोड करने के लिए, load_environment_config को कॉल करें:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

हर बार इसे कॉल करने पर, एनवायरमेंट वैरिएबल की मौजूदा स्थिति, Config में पहले से मौजूद हर चीज़ को बदल देगी. उदाहरण के लिए, इस तरीके की मदद से, डिफ़ॉल्ट कॉन्फ़िगरेशन को कॉन्फ़िगर किया जा सकता है, लेकिन एनवायरमेंट वैरिएबल का इस्तेमाल करके खास वैल्यू को बदला जा सकता है या एनवायरमेंट वैरिएबल को पूरी तरह से कॉन्फ़िगर किया जा सकता है.

सभी लाइब्रेरी के साथ काम करने वाले एनवायरमेंट वैरिएबल के अलावा, रूबी लाइब्रेरी में दो अतिरिक्त वैरिएबल होते हैं:

• GOOGLE_ADS_RUBY_LOG_LEVEL: ऊपर log_level के तौर पर.
• GOOGLE_ADS_RUBY_HTTP_PROXY: कोई एचटीटीपी प्रॉक्सी तय करें.