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

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

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

REST API প্রোটোকল

মনে রাখবেন: Google Ads API, স্ট্যান্ডার্ড JSON REST এন্ডপয়েন্ট ও হাই-পারফর্ম্যান্স gRPC ইন্টারফেস, দু'টিই প্রকাশ করে। gRPC স্ট্যাকে Perl সমর্থিত ভাষা নয়, তাই এই ক্লায়েন্ট লাইব্রেরি HTTP 1.1-এর মাধ্যমে JSON REST প্রোটোকলে প্রয়োগ করা হয়।

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

Google Ads API-এর সাথে কানেক্ট করতে, ক্লায়েন্ট লাইব্রেরি JSON-এ HTTP অনুরোধ তৈরি করে, HTTP 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::GoogleAds::Client রিলিজ নির্দিষ্ট Google Ads API ভার্সন মডিউলকে lib/Google/Ads/GoogleAds/-এর অধীনে বান্ডেল করে (যেখানে v25.1-এর মতো ছোট API রিলিজ তাদের প্রধান ভার্সন মডিউল, V25-এর অধীনে অন্তর্ভুক্ত করা হয়)। ভার্সন কম্প্যাটিবিলিটির জন্য সমর্থিত API ভার্সন টেবিল দেখুন।

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

Google Ads API ব্যবহার করতে, API-তে অ্যাক্সেস পেতে এবং আপনার Google Ads অ্যাকাউন্ট কনফিগার করতে আপনাকে বেশ কয়েকটি ধাপ সম্পূর্ণ করতে হবে। দ্রুত শুরুর নির্দেশিকা অনুসরণ করুন, যা আপনাকে Google Ads অ্যাকাউন্ট সেট-আপ করা সহ সমস্ত গুরুত্বপূর্ণ ধাপের মাধ্যমে নিয়ে যায়।

প্রাথমিক ব্যবহার

Perl ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় সেই সম্পর্কে আরও জানতে ব্যবহারের প্রাথমিক নির্দেশিকা দেখুন।

যাচাইকরণ ও অনুমোদন

Perl ক্লায়েন্ট লাইব্রেরি যাচাইকরণ ও অনুমোদনের জন্য একাধিক পদ্ধতি সমর্থন করে। আরও জানতে যাচাইকরণ ও অনুমোদন গাইড দেখুন।

কনফিগারেশন ও লগিং

Perl ক্লায়েন্ট লাইব্রেরি কনফিগারেশনের জন্য googleads.properties এবং লগ-ইন করার জন্য log4perl.conf ব্যবহার করে। লাইব্রেরির আচরণ কাস্টমাইজ করতে আপনি এইসব ফাইল পরিবর্তন করতে পারবেন। আরও জানতে কনফিগারেশন এবং লগিং সংক্রান্ত নির্দেশিকা দেখুন।

ইউটিলিটি

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

• ফিল্ড মাস্ক
• রিসোর্সের নাম

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

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