আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

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

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

GitHub থেকে লাইব্রেরি ক্লোন করুন:
```
git clone https://github.com/googleads/google-ads-perl.git
```
google-ads-perl ডিরেক্টরিতে পরিবর্তন করুন:
```
cd google-ads-perl
```
আপনি কিছু ফাইল ও সাবডিরেক্টরি দেখতে পাবেন:
- Build.PL: Perl বিল্ড ফাইল, যা এই প্রোজেক্টের ডিপেন্ডেন্সি ও টেস্টের ধরন ধরে রাখে।
- lib: লাইব্রেরির সোর্স কোড।
- t: লাইব্রেরি কোডের টেস্ট কেস।
- examples: Google Ads API ব্যবহার করে সাধারণ ব্যবহারের ক্ষেত্রে কার্যকর করার জন্য লাইব্রেরি কীভাবে ব্যবহার করতে হয় তা প্রদর্শন করে এমন অনেক উদাহরণ।
- googleads.properties: লাইব্রেরির জন্য স্যাম্পেল কনফিগারেশন ফাইল।
- log4perl.conf: স্যাম্পেল লগিং কনফিগারেশন ফাইল।
প্রয়োজনীয় ডিপেন্ডেন্সি ইনস্টল করে লাইব্রেরি তৈরি করুন। 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 ক্লায়েন্ট লাইব্রেরিতে ইউটিলিটি ক্লাস অন্তর্ভুক্ত থাকে। আরও জানতে নিম্নলিখিত নির্দেশিকা দেখুন:

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

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