ক্লায়েন্ট লাইব্রেরির প্রাথমিক ব্যবহার নিচে দেওয়া হল:
ইনস্টল করা
লাইব্রেরি ইনস্টল করার সাজেস্ট করা পদ্ধতি হল 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 থেকে শুরু করে, gem Bundler
autorequire (Bundler.require) কাজ করে। v41.1.0-এর আগের ভার্সনে (অথবা Bundler.require ব্যবহার না
করলে), আপনার কোডে gem স্পষ্টভাবে প্রয়োজন:
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-এ থাকা এরর হ্যান্ডলারের উদাহরণ দেখুন।