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

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

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