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 का इस्तेमाल करके डिस्ट्रिब्यूट किया जाता है.

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

cpanm (या cpan) का इस्तेमाल करके, सीधे CPAN से Google::Ads::GoogleAds::Client डिस्ट्रिब्यूशन इंस्टॉल करें:

cpanm Google::Ads::GoogleAds::Client

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

सोर्स से बनाएं और उदाहरण चलाएं

बंडल किए गए कोड के उदाहरणों को चलाने या सोर्स से लाइब्रेरी बनाने के लिए:

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 खाते सेट अप करना.

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

Google::Ads::GoogleAds::Client को शुरू करें (यह डिफ़ॉल्ट रूप से ~/googleads.properties या GOOGLE_ADS_CONFIGURATION_FILE_PATH से क्रेडेंशियल लोड करता है) और SearchStreamHandler का इस्तेमाल करके कैंपेन की लाइनें स्ट्रीम करें:

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

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

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

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

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

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

उपयोगिताएं

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

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

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

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