ক্লায়েন্ট লাইব্রেরির মৌলিক ব্যবহার নিম্নরূপ:
ইনস্টলেশন
ইনস্টল করার প্রস্তাবিত পদ্ধতি হলো বান্ডলার ব্যবহার করা। আপনার Gemfile এ একটি লাইন যোগ করুন (xyz-এর জায়গায় আপনার পছন্দের ভার্সন নম্বরটি বসান):
gem 'google-ads-googleads', '~> x.y.z'
তারপর চালান:
$ bundle install
এই কমান্ডটি বান্ডলার ব্যবহার করে আপনার Gemfile.lock আপডেট করে, যা জেম এবং এর সমস্ত ডিপেন্ডেন্সির ইনস্টল করা নির্দিষ্ট ভার্সনটিকে লক করে দেয়। পেসিমিস্টিক ভার্সন অপারেটর "~> xyz" এর কারণে bundle update শুধুমাত্র xy* সিরিজের নতুন ভার্সনগুলো ইনস্টল করে, তাই আপনাকে ম্যানুয়ালি আপনার Gemfile আবার আপডেট করে নতুন ভার্সনগুলো ইনস্টল করার জন্য সম্মতি জানাতে হবে।
অন্যান্য ইনস্টলেশন বিকল্পগুলি
আপনি যদি বান্ডলার ব্যবহার না করেন, তাহলে এই বিকল্পগুলোর মধ্যে একটি ব্যবহার করতে পারেন:
- gem ব্যবহার করে এই লাইব্রেরিটি ইনস্টল করুন:
terminal $ [sudo] gem install google-ads-googleads - রিলিজ পেজ থেকে জেমটি ডাউনলোড করুন এবং লোকাল ফাইল থেকে এটি ইনস্টল করুন:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
প্রমাণীকরণ সেট আপ করুন
আপনার এপিআই কলগুলো প্রমাণীকরণ করতে, প্রমাণীকরণ এবং অনুমোদন পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন।
ব্যবহার
আপনার কোডে জেমটি অন্তর্ভুক্ত করতে:
require 'google/ads/google_ads'
একটি নির্দিষ্ট সার্ভিস, যেমন CampaignService, আনতে:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
লাইব্রেরিটি কীভাবে ব্যবহার করতে হয় তার আরও বিস্তারিত প্রদর্শনের জন্য গিটহাবে থাকা উদাহরণগুলো দেখুন।
উদাহরণগুলোর সাথে পরিচিত হওয়ার পর, আমরা আপনাকে ফ্যাক্টরিগুলোর সাথেও পরিচিত হওয়ার পরামর্শ দিই, যা গুগল অ্যাডস এপিআই (Google Ads API) নিয়ে কাজ করার জন্য কিছু উচ্চ-স্তরের সুবিধাজনক মেথড সরবরাহ করে।
ত্রুটি পরিচালনা
সব এপিআই কল সফল হবে না। কোনো কারণে আপনার এপিআই কল ব্যর্থ হলে সার্ভার ত্রুটি দেখাতে পারে। এপিআই ত্রুটিগুলো শনাক্ত করা এবং যথাযথভাবে সেগুলোর সমাধান করা জরুরি।
যখন কোনো এপিআই (API) ত্রুটি ঘটে, তখন একটি GoogleAdsException ইনস্ট্যান্স থ্রো করা হয়। কী ভুল হয়েছে তা বুঝতে সাহায্য করার জন্য এতে বিস্তারিত তথ্য থাকে এবং আপনি ত্রুটিগুলো হ্যান্ডেল করার জন্য একটি হেল্পার ফাংশন সেট আপ করতে পারেন। গিটহাবে (GitHub) একটি এরর হ্যান্ডলারের উদাহরণ দেখুন।