Perl ক্লায়েন্ট লাইব্রেরি

Perl ক্লায়েন্ট লাইব্রেরি GitHub-এ হোস্ট করা হয় এবং প্যাকেজটি CPAN-এ উপলভ্য।

লাইব্রেরি Perl ভার্সন 5.28.1 বা তার পরবর্তী ভার্সনে কাজ করে।

REST API প্রোটোকল

Perl ক্লায়েন্ট লাইব্রেরিতে ক্লাস এন্টিটি—যেমন পরিষেবা, রিসোর্স, এনাম ও সমস্যা—প্রোটোকল বাফার সংজ্ঞা পার্স করার মাধ্যমে তৈরি করা হয়। স্ট্রাকচার্ড ডেটা কীভাবে সিরিয়ালাইজ করা হয় সেই সম্পর্কে আরও জানতে, প্রোটোকল বাফার ডকুমেন্টেশন দেখুন।

Google Ads API-এর সাথে কানেক্ট করতে, ক্লায়েন্ট লাইব্রেরি JSON-এ HTTP অনুরোধ তৈরি করে, HTTP 1.1-এর মাধ্যমে REST এন্ডপয়েন্টে পাঠায়, JSON অবজেক্ট হিসেবে উত্তর ডিসিরিয়ালাইজ করে এবং ফলাফল ব্যাখ্যা করে।

লাইব্রেরি ইনস্টল করুন

Perl ক্লায়েন্ট লাইব্রেরি GitHub-এ হোস্ট করা হয় এবং CPAN ব্যবহার করে ডিস্ট্রিবিউট করা হয়।

CPAN থেকে ইনস্টল করুন

cpanm (বা cpan) ব্যবহার করে সরাসরি CPAN থেকে Google::Ads::GoogleAds::Client ডিস্ট্রিবিউশন ইনস্টল করুন:

cpanm Google::Ads::GoogleAds::Client

সোর্স থেকে তৈরি করুন এবং উদাহরণ রান করুন

বান্ডেল করা কোডের উদাহরণ রান করতে বা সোর্স থেকে লাইব্রেরি তৈরি করতে:

  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

আপনার প্রথম API কল করুন

Google Ads API ব্যবহার করতে, 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 ব্যবহার করে। লাইব্রেরির আচরণ কাস্টমাইজ করতে আপনি এইসব ফাইল পরিবর্তন করতে পারবেন। আরও জানতে কনফিগারেশন এবং লগিং সংক্রান্ত নির্দেশিকা দেখুন।

ইউটিলিটি

API-এর ব্যবহারযোগ্যতা উন্নত করতে Perl ক্লায়েন্ট লাইব্রেরিতে ইউটিলিটি ক্লাস অন্তর্ভুক্ত থাকে। আরও জানতে নিম্নলিখিত নির্দেশিকা দেখুন:

আপনার অ্যাপ্লিকেশনের পারফর্ম্যান্স ফাইন-টিউন করুন

আপনার অ্যাপ্লিকেশনের পারফর্ম্যান্স কীভাবে ফাইন-টিউন করবেন সেই বিষয়ে সাজেশন পেতে পারফর্ম্যান্স গাইড দেখুন।