क्लाइंट लाइब्रेरी का बुनियादी इस्तेमाल इस तरह किया जाता है:
इंस्टॉल करना
हमारा सुझाव है कि लाइब्रेरी को इंस्टॉल करने के लिए, Bundler का इस्तेमाल करें. अपनी Gemfile में एक लाइन जोड़ें (x.y.z को उस वर्शन नंबर से बदलें जिसका आपको इस्तेमाल करना है):
gem 'google-ads-googleads', '~> x.y.z'
इसके बाद, यह कमांड चलाएं:
bundle install
यह कमांड, Bundler का इस्तेमाल करके Gemfile.lock को अपडेट करती है. साथ ही, इंस्टॉल किए गए gem और gem की सभी डिपेंडेंसी के सटीक वर्शन को लॉक करती है. पैसेमिस्टिक वर्शन ऑपरेटर "~> x.y.z" यह पक्का करता है कि bundle install या bundle update सिर्फ़ x.y.* सीरीज़ में नए पैच वर्शन इंस्टॉल करे. इसलिए, आपको Gemfile को अपडेट करके, नए माइनर या मेजर वर्शन में मैन्युअल तरीके से ऑप्ट-इन करना होगा.
इंस्टॉल करने के अन्य विकल्प
अगर Bundler का इस्तेमाल नहीं किया जा रहा है, तो इनमें से किसी एक विकल्प का इस्तेमाल करें:
RubyGems का इस्तेमाल करके, इस लाइब्रेरी को इंस्टॉल करें:
gem install google-ads-googleadsरिलीज़ पेज से gem डाउनलोड करें और इसे स्थानीय फ़ाइल से इंस्टॉल करें:
gem install google-ads-googleads-[version].gem
पुष्टि करने की सुविधा सेट अप करना
अपने एपीआई कॉल की पुष्टि करने के लिए, अपनी google_ads_config.rb फ़ाइल कॉन्फ़िगर करें. साथ ही, पुष्टि और अनुमति पेज पर दिए गए निर्देशों का पालन करें.
इस्तेमाल
google-ads-googleads v41.1.0 से, gem, Bundler autorequire (Bundler.require) के साथ काम करता है. v41.1.0 से पहले के वर्शन में (या Bundler.require का इस्तेमाल न करने पर), अपने कोड में gem को साफ़ तौर पर शामिल करें:
require 'google/ads/google_ads'
क्लाइंट को शुरू करें. यह ~/google_ads_config.rb से डिफ़ॉल्ट रूप से कॉन्फ़िगरेशन लोड करता है. इसके बाद, CampaignService जैसी कोई खास सेवा फ़ेच करें:
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
campaign_service = client.service.campaign
लाइब्रेरी का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, GitHub पर दिए गए उदाहरण देखें.
उदाहरणों के बारे में जानने के बाद, फ़ैक्ट्रियों के बारे में जानें. ये Google Ads API के साथ काम करने के लिए, हाई-लेवल के सुविधाजनक तरीकों का सेट उपलब्ध कराती हैं.
गड़बड़ी ठीक करना
ऐसा ज़रूरी नहीं है कि हर एपीआई कॉल पूरा हो. अगर आपके एपीआई कॉल पूरे नहीं होते हैं, तो सर्वर अपवादों को बढ़ाता है. एपीआई से जुड़ी गड़बड़ियों को कैप्चर करना और उन्हें ठीक तरीके से मैनेज करना ज़रूरी है.
एपीआई में गड़बड़ी होने पर, Google::Ads::GoogleAds::Errors::GoogleAdsError इंस्टेंस ट्रिगर होता है. इसमें गड़बड़ी की वजह जानने में आपकी मदद करने के लिए जानकारी होती है. साथ ही, गड़बड़ियों को ठीक करने के लिए हेल्पर फ़ंक्शन सेट अप किया जा सकता है. GitHub पर गड़बड़ी हैंडलर का उदाहरण देखें.