क्लाइंट लाइब्रेरी का बुनियादी इस्तेमाल इस तरह किया जाता है:
इंस्टॉल करना
लाइब्रेरी इंस्टॉल करने के लिए, Bundler का इस्तेमाल करने का सुझाव दिया जाता है. अपनी Gemfile में एक लाइन जोड़ें (x.y.z को उस वर्शन नंबर से बदलें जिसका आपको इस्तेमाल करना है):
gem 'google-ads-googleads', '~> x.y.z'
इसके बाद, यह चलाएं:
bundle install
यह कमांड, आपके Gemfile.lock को अपडेट करने के लिए Bundler का इस्तेमाल करता है. साथ ही, यह 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 पर गड़बड़ी हैंडलर का उदाहरण देखें.