এপিআই ব্যবহার করার সময় প্রোটো ক্লাসের রেফারেন্স খুঁজে বের করতে হলে হয় এপিআই সম্পর্কে আপনার অন্তর্নিহিত ধারণা থাকতে হবে, অথবা সঠিক পাথটি জানার জন্য আপনাকে ঘন ঘন প্রোটো রেফারেন্স ডকুমেন্টেশন দেখতে হবে।
ProtoLookupUtil
প্রোটো লুকআপ ইউটিল আপনাকে এপিআই ভার্সন নম্বর এবং নেমস্পেস মনে রাখার ঝামেলা ছাড়াই সার্ভিস, অপারেশন, এনুমারেশন এবং রিসোর্সের ইনস্ট্যান্স খুঁজে বের করতে ও তৈরি করতে দেয়।
সাধারণত এইভাবেই একটি ক্যাম্পেইন শুরু করা হয়:
campaign = Google::Ads::GoogleAds::V25::Resources::Campaign.new
কিন্তু প্রোটো লুকআপ ইউটিল ব্যবহার করে, আপনি একটি আরও সরল রূপ ব্যবহার করতে পারেন:
campaign = client.resource.campaign
কোনো রিসোর্স, সার্ভিস বা অপারেশন ফেচ করার সময়, সেই এনটিটির একটি ইনস্ট্যান্স রিটার্ন করা হয়। কোনো এনুমারেশন ফেচ করার সময়, ইনস্ট্যানসিয়েশন ছাড়াই ক্লাসটির একটি রেফারেন্স রিটার্ন করা হয়।
এনুমারেশনের ক্ষেত্রে, এনুমারেশন প্রোটোগুলো খুঁজে বের করার প্রয়োজনীয়তা এড়ানোর জন্য আপনি একটি শর্টকাট ব্যবহার করতে পারেন।
campaign.status = :PAUSED
আপনি এই ইউটিলিটিটি অন্য কোনো কাজে ব্যবহার না করলেও, সার্ভিসগুলো ফেচ করার জন্য আমরা client.service মেথডটি ব্যবহার করার পরামর্শ দিই। আপনার অথেনটিকেশন ডিটেইলস পাস করার জন্য এই মেথডটিতে অতিরিক্ত লজিক রয়েছে, যা অন্য কোনো মেথড ব্যবহার করলে আপনাকে ম্যানুয়ালি হ্যান্ডেল করতে হতো।