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