Perl Client लाइब्रेरी

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

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

REST API प्रोटोकॉल

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

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
perl Build installdeps

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

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

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

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

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

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

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

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

उपयोगिताएं

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

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

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