গুগল অ্যাডস এপিআই এক্সপ্লোরার হলো একটি ইন্টারেক্টিভ এক্সিকিউশন এনভায়রনমেন্ট, যা আপনাকে সরাসরি আপনার ব্রাউজার থেকে লাইভ এপিআই রিকোয়েস্ট তৈরি ও পাঠানোর সুযোগ দেয়। রেফারেন্স ডকুমেন্টেশনের মধ্যে এমবেড করা এই টুলটি OAuth 2.0 অথেন্টিকেশন এবং JSON পেলোড ফরম্যাটিং-এর জটিলতাগুলো সামলে নেয়, যার ফলে আপনি এক লাইন কোডও না লিখে নির্দিষ্ট সার্ভিস ও মেথড পরীক্ষা করতে পারেন।
সুবিধা
- নো-কোড টেস্টিং: কোনো লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ না করেই সরাসরি ডকুমেন্টেশন থেকে লাইভ এপিআই কল (রিড এবং রাইট উভয়ই) চালান।
- প্রোটোকল আবিষ্কার: এপিআই কীভাবে কাজ করে তা বোঝার জন্য এইচটিটিপি অনুরোধ এবং প্রতিক্রিয়ার সঠিক কাঠামো দেখুন।
- সহজ প্রোটোটাইপিং: আপনার অ্যাপ্লিকেশনে লজিক প্রয়োগ করার আগেই এন্ডপয়েন্টের আচরণ যাচাই করুন এবং সরাসরি এপিআই প্রতিক্রিয়াগুলো পরীক্ষা করুন।
- সরলীকৃত প্রমাণীকরণ: টুলটি স্বয়ংক্রিয়ভাবে OAuth 2.0 ফ্লো পরিচালনা করে, ফলে আপনি ক্রেডেনশিয়াল ব্যবস্থাপনার পরিবর্তে এপিআই অনুরোধের উপর মনোযোগ দিতে পারেন।
শুরু করা হচ্ছে
- ডকুমেন্টেশনে যান: রেফারেন্স ডকুমেন্টেশনে যান এবং আপনি যে সার্ভিস ও মেথডটি পরীক্ষা করতে চান, যেমন
GoogleAdsService/Search, তা নির্বাচন করুন। - এক্সপ্লোরারটি খুলুন: পেজের ডানদিকে "Try it!" প্যানেলটি খুঁজুন।
- অনুরোধটি কনফিগার করুন:
- প্রয়োজনীয় রিকোয়েস্ট প্যারামিটারগুলো, যেমন
developer-tokenএবংlogin-customer-id, প্রবেশ করান। - যদি মেথডটির জন্য পেলোডের প্রয়োজন হয়, যেমন
mutateঅপারেশনের ক্ষেত্রে, তাহলে ইন্টারেক্টিভ JSON এডিটর ব্যবহার করে রিকোয়েস্ট বডি নির্ধারণ করুন।
- প্রয়োজনীয় রিকোয়েস্ট প্যারামিটারগুলো, যেমন
- এক্সিকিউট: অনুরোধটি পাঠাতে এক্সিকিউট-এ ক্লিক করুন। টুলটি সম্পূর্ণ HTTP অনুরোধ এবং API থেকে প্রাপ্ত লাইভ JSON প্রতিক্রিয়া প্রদর্শন করবে।
মূল বৈশিষ্ট্য
- সরাসরি সম্পাদন: আপনার প্রোডাকশন বা টেস্ট অ্যাকাউন্টগুলোতে রিয়েল-টাইমে
searchএবংmutateকার্যক্রম পরিচালনা করুন। - JSON পেলোড ফরম্যাটিং: অনুরোধের জন্য ইন্টারেক্টিভভাবে জটিল JSON অবজেক্ট তৈরি করুন, যেখানে টুলটি প্রয়োজনীয় ফিল্ড এবং বৈধ স্কিমা কাঠামো হাইলাইট করে।
- ফিল্ড মাস্ক: আংশিক রিসোর্স আপডেট বাস্তবে কীভাবে কাজ করে তা দেখতে একটি
update_maskলজিক পরীক্ষা করুন। - ত্রুটি পরিদর্শন: দ্রুত ডিবাগিংয়ের সুবিধার্থে মূল রেসপন্সে বিস্তারিত ত্রুটির বার্তা এবং কোড (যেমন
QUERY_ERRORবাAUTHENTICATION_ERROR) দেখুন। - কোড এক্সপোর্ট: এপিআই এক্সপ্লোরারের বর্ধিত ভিউ থেকে
curlকমান্ড, সরাসরি এইচটিটিপি রিকোয়েস্ট, বা নমুনা জাভাস্ক্রিপ্ট কোড এক্সপোর্ট করুন।
ব্যবহারের উদাহরণ
- অ্যাকাউন্ট সেটিংস নিরীক্ষা করুন: একটি
getবাsearchরিকোয়েস্ট চালিয়ে দ্রুত অ্যাকাউন্ট-স্তরের কনফিগারেশন বা মেটাডেটা পুনরুদ্ধার করুন। - টেস্ট মিউটেশন: প্রোডাকশনে কোড ডেপ্লয় করার আগে কোনো ক্যাম্পেইন তৈরি বা বাজেট আপডেটের সাফল্য যাচাই করুন।
- GAQL ডিবাগ করুন: এক্সপ্লোরার ব্যবহার করে একটি গুগল অ্যাডস কোয়েরি ল্যাঙ্গুয়েজ (GAQL) স্ট্রিং চালান এবং যাচাই করুন যে ফেরত আসা JSON কাঠামোটি আপনার অ্যাপ্লিকেশনের প্রত্যাশার সাথে মেলে।
- প্রোটোকল যাচাইকরণ: একটি নির্দিষ্ট এপিআই সংস্করণের জন্য প্রয়োজনীয় সুনির্দিষ্ট HTTP হেডার এবং JSON নেস্টিং পরীক্ষা করুন।