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

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
./Build installdeps
./Build
./Build install

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

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

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

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

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

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

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

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

उपयोगिताएं

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

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

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