ক্লায়েন্ট লাইব্রেরির প্রাথমিক ব্যবহার নিচে দেওয়া হল:
ইনস্টল করা
Bundler ব্যবহার করে লাইব্রেরি ইনস্টল করার সাজেশন দেওয়া হয়। আপনার Gemfile-এ
একটি লাইন যোগ করুন (x.y.z-এর জায়গায় আপনি যে ভার্সন নম্বর ব্যবহার করতে চান সেটি লিখুন):
gem 'google-ads-googleads', '~> x.y.z'
তারপর রান করুন:
bundle install
এই কমান্ড আপনার Gemfile.lock আপডেট করতে Bundler ব্যবহার করে, যা জেমের সঠিক ভার্সন এবং ইনস্টল করা জেমের সমস্ত ডিপেন্ডেন্সি লক করে। পেসিমেস্টিক
ভার্সন অপারেটর "~> x.y.z" নিশ্চিত করে যে bundle install বা
bundle update শুধুমাত্র x.y.* সিরিজে নতুন প্যাচ ভার্সন ইনস্টল করে, তাই আপনাকে
অবশ্যই ম্যানুয়ালি আপনার Gemfile আপডেট করে নতুন মাইনর বা মেজর ভার্সন বেছে নিতে হবে।
ইনস্টলেশনের অন্যান্য বিকল্প
আপনি Bundler ব্যবহার না করলে, এইসব বিকল্পের মধ্যে থেকে যেকোনও একটি ব্যবহার করতে পারবেন:
RubyGems ব্যবহার করে এই লাইব্রেরি ইনস্টল করুন:
gem install google-ads-googleadsরিলিজ পৃষ্ঠা থেকে gem ডাউনলোড করুন এবং লোকাল ফাইল থেকে এটি ইনস্টল করুন:
gem install google-ads-googleads-[version].gem
যাচাইকরণ সেট-আপ করা
আপনার API কল যাচাই করতে, আপনার google_ads_config.rb ফাইল কনফিগার করুন এবং
যাচাইকরণ ও অনুমোদন পৃষ্ঠায়
দেওয়া নির্দেশাবলী অনুসরণ করুন।
ব্যবহার
google-ads-googleads v41.1.0 থেকে শুরু করে, জেম Bundler
autorequire (Bundler.require) সাপোর্ট করে। v41.1.0-এর আগের ভার্সনে (অথবা Bundler.require
ব্যবহার না করলে), আপনার কোডে স্পষ্টভাবে জেমের প্রয়োজন হয়:
require 'google/ads/google_ads'
ক্লায়েন্ট ইনিশিয়ালাইজ করুন (যা ডিফল্ট হিসেবে ~/google_ads_config.rb
থেকে কনফিগারেশন লোড করে) এবং নির্দিষ্ট পরিষেবা ফেচ করুন, যেমন CampaignService:
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
campaign_service = client.service.campaign
লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার আরও বিস্তারিত ডেমো দেখতে GitHub-এ উদাহরণ দেখুন।
উদাহরণগুলি সম্পর্কে পরিচিত হওয়ার পরে, ফ্যাক্টরি এক্সপ্লোর করুন, যা Google Ads API-এর সাথে কাজ করার জন্য উচ্চ-স্তরের সুবিধাজনক পদ্ধতির একটি সেট প্রদান করে।
সমস্যা ম্যানেজ করা
সব API কল সফল হয় না। আপনার API কল ব্যর্থ হলে সার্ভার ব্যতিক্রম তুলে ধরে। API সংক্রান্ত সমস্যা ক্যাপচার করা এবং সেগুলি যথাযথভাবে ম্যানেজ করা গুরুত্বপূর্ণ।
API সংক্রান্ত সমস্যা হলে Google::Ads::GoogleAds::Errors::GoogleAdsError ইনস্ট্যান্স
তৈরি হয়। এতে এমন বিবরণ থাকে যা আপনাকে কী ভুল হয়েছে তা নির্ধারণ করতে সাহায্য করে এবং
আপনি সমস্যাগুলি সমাধান করার জন্য একটি হেল্পার ফাংশন সেট-আপ করতে পারেন। GitHub-এ সমস্যা হ্যান্ডলার-এর
উদাহরণ দেখুন।