Perl क्लाइंट लाइब्रेरी

Perl क्लाइंट लाइब्रेरी को GitHub पर होस्ट किया गया है. साथ ही, इसका पैकेज CPAN पर उपलब्ध है.

यह लाइब्रेरी, Perl के 5.28.1 या इसके बाद के वर्शन के साथ काम करती है.

REST API प्रोटोकॉल

ध्यान दें: Google Ads API, स्टैंडर्ड JSON REST एंडपॉइंट और बेहतर परफ़ॉर्मेंस वाले gRPC इंटरफ़ेस, दोनों को एक्सपोज़ करता है. gRPC स्टैक में Perl इस्तेमाल नहीं किया जा सकता. इसलिए, इस क्लाइंट लाइब्रेरी को एचटीटीपी 1.1 पर JSON REST प्रोटोकॉल के साथ लागू किया गया है.

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

Google Ads API से कनेक्ट करने के लिए, क्लाइंट लाइब्रेरी JSON में एक एचटीटीपी अनुरोध बनाती है. इसके बाद, इसे एचटीटीपी 1.1 पर REST एंडपॉइंट को भेजती है. इसके बाद, जवाब को JSON ऑब्जेक्ट के तौर पर डीसीरियलाइज़ करती है और नतीजों की व्याख्या करती है.

लाइब्रेरी इंस्टॉल करना

Perl क्लाइंट लाइब्रेरी को GitHub पर होस्ट किया जाता है और CPAN का इस्तेमाल करके डिस्ट्रिब्यूट किया जाता है.

1. GitHub से लाइब्रेरी को क्लोन करें:

   git clone https://github.com/googleads/google-ads-perl.git
   

2. google-ads-perl डायरेक्ट्री में जाएं:

   cd google-ads-perl
   

   आपको कुछ फ़ाइलें और सबडायरेक्ट्री दिखेंगी:

   • Build.PL: Perl बिल्ड फ़ाइल, जिसमें इस प्रोजेक्ट की डिपेंडेंसी और टेस्ट टाइप शामिल हैं.
   • lib: लाइब्रेरी का सोर्स कोड.
   • t: लाइब्रेरी कोड के टेस्ट केस.
   • examples: कई उदाहरण, जिनसे पता चलता है कि Google Ads API का इस्तेमाल करके, सामान्य इस्तेमाल के उदाहरणों को लागू करने के लिए, लाइब्रेरी का इस्तेमाल कैसे किया जाता है.
   • googleads.properties: लाइब्रेरी के लिए सैंपल कॉन्फ़िगरेशन फ़ाइल.
   • log4perl.conf: सैंपल लॉगिंग कॉन्फ़िगरेशन फ़ाइल.

3. ज़रूरी डिपेंडेंसी इंस्टॉल करें और लाइब्रेरी बनाएं. Build.PL फ़ाइल में, लाइब्रेरी के लिए ज़रूरी सभी डिपेंडेंसी की सूची दी गई है. इन्हें इंस्टॉल करने के लिए, ये कमांड चलाएं:

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

ध्यान दें: हर Google::Ads::GoogleAds::Client रिलीज़, lib/Google/Ads/GoogleAds/ के तहत Google Ads API के खास वर्शन मॉड्यूल को बंडल करती है. इसमें v25.1 जैसी छोटी एपीआई रिलीज़, उनके मुख्य वर्शन मॉड्यूल V25 के तहत शामिल होती हैं. वर्शन के साथ काम करने की जानकारी के लिए, एपीआई के साथ काम करने वाले वर्शन की टेबल देखें.

अपना पहला एपीआई कॉल करना

Google Ads API का इस्तेमाल करने के लिए, आपको एपीआई का ऐक्सेस पाने और अपने Google Ads खातों को कॉन्फ़िगर करने के लिए, कई चरण पूरे करने होंगे. क्विक स्टार्ट गाइड पढ़ें. इसमें सभी ज़रूरी चरणों के बारे में बताया गया है. जैसे, Google Ads खाते सेट अप करना.

बुनियादी इस्तेमाल

Perl क्लाइंट लाइब्रेरी इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, इस्तेमाल करने से जुड़ी बुनियादी गाइड पढ़ें.

पुष्टि करना और अनुमति देना

Perl क्लाइंट लाइब्रेरी, पुष्टि करने और अनुमति देने के कई तरीकों के साथ काम करती है. ज़्यादा जानने के लिए, पुष्टि और अनुमति गाइड देखें.

कॉन्फ़िगरेशन और लॉगिंग

Perl क्लाइंट लाइब्रेरी, कॉन्फ़िगरेशन के लिए googleads.properties और लॉगिंग के लिए log4perl.conf का इस्तेमाल करती है. लाइब्रेरी के काम करने के तरीके को पसंद के मुताबिक बनाने के लिए, इन फ़ाइलों में बदलाव किया जा सकता है. ज़्यादा जानने के लिए, कॉन्फ़िगरेशन और लॉगिंग गाइड देखें.

उपयोगिताएं

Perl क्लाइंट लाइब्रेरी में, एपीआई की उपयोगिता को बेहतर बनाने के लिए यूटिलिटी क्लास शामिल हैं. ज़्यादा जानने के लिए, यहां दी गई गाइड पढ़ें:

• फ़ील्ड मास्क
• संसाधन के नाम

अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाना

अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाने के सुझावों के लिए, परफ़ॉर्मेंस गाइड देखें.