क्लाइंट लाइब्रेरी का बुनियादी इस्तेमाल इस तरह किया जाता है:
इंस्टॉल करना
हमारा सुझाव है कि आप bundler का इस्तेमाल करके इंस्टॉल करें. अपनी Gemfile में एक लाइन जोड़ें (x.y.z को उस वर्शन नंबर से बदलें जिसमें आपकी दिलचस्पी है):
gem 'google-ads-googleads', '~> x.y.z'
इसके बाद, यह कमांड चलाएं:
$ bundle install
यह कमांड, बंडलर का इस्तेमाल करके आपके Gemfile.lock को अपडेट करती है. साथ ही, इंस्टॉल किए गए gem और gem की सभी डिपेंडेंसी के सटीक वर्शन को लॉक करती है. पैसेमिस्टिक वर्शन ऑपरेटर "~> x.y.z" की वजह से, bundle update सिर्फ़ x.y.* सीरीज़ के नए वर्शन इंस्टॉल करता है. इसलिए, आपको Gemfile को फिर से अपडेट करके, नए वर्शन में मैन्युअल तरीके से ऑप्ट-इन करना होगा.
इंस्टॉल करने के अन्य विकल्प
अगर बंडलर का इस्तेमाल नहीं किया जा रहा है, तो इनमें से किसी एक विकल्प का इस्तेमाल किया जा सकता है:
- gem का इस्तेमाल करके, इस लाइब्रेरी को इंस्टॉल करें:
terminal $ [sudo] gem install google-ads-googleads - Releases page से gem डाउनलोड करें और इसे स्थानीय फ़ाइल से इंस्टॉल करें:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
पुष्टि करने की सुविधा सेट अप करना
अपने एपीआई कॉल की पुष्टि करने के लिए, पुष्टि और अनुमति पेज पर दिए गए निर्देशों का पालन करें.
इस्तेमाल
अपने कोड में gem शामिल करने के लिए:
require 'google/ads/google_ads'
किसी सेवा को फ़ेच करने के लिए, उदाहरण के लिए CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
लाइब्रेरी को इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, GitHub पर दिए गए उदाहरण देखें.
उदाहरणों के बारे में जानने के बाद, हमारा सुझाव है कि आप फ़ैक्ट्रियों के बारे में भी जान लें. ये Google Ads API के साथ काम करने के लिए, कई सुविधाजनक तरीके उपलब्ध कराती हैं.
गड़बड़ी ठीक करना
यह ज़रूरी नहीं है कि हर एपीआई कॉल पूरा हो. अगर किसी वजह से आपके एपीआई कॉल पूरे नहीं हो पाते, तो सर्वर गड़बड़ियां दिखा सकता है. एपीआई की गड़बड़ियों को कैप्चर करना और उन्हें सही तरीके से ठीक करना ज़रूरी है.
एपीआई से जुड़ी गड़बड़ी होने पर, GoogleAdsException इंस्टेंस थ्रो किया जाता है. इसमें गड़बड़ी की जानकारी होती है, ताकि आपको यह पता चल सके कि क्या गड़बड़ी हुई है. साथ ही, गड़बड़ियों को ठीक करने के लिए हेल्पर फ़ंक्शन सेट अप किया जा सकता है. GitHub पर मौजूद, गड़बड़ी ठीक करने वाले फ़ंक्शन का उदाहरण देखें.