একটি সফল গুগল অ্যাডস এপিআই ইন্টিগ্রেশন তৈরির ক্ষেত্রে টেস্টিং একটি গুরুত্বপূর্ণ পদক্ষেপ, আপনি সবে শুরু করছেন, কোনো অ্যাপ রক্ষণাবেক্ষণ করছেন, বা বিদ্যমান ইন্টিগ্রেশনে নতুন ফিচার যোগ করছেন—যা-ই করুন না কেন। এই নির্দেশিকাটিতে আপনার গুগল অ্যাডস এপিআই ইন্টিগ্রেশন পরীক্ষা করার জন্য কিছু সেরা পদ্ধতি তুলে ধরা হয়েছে।
টেস্ট অ্যাকাউন্ট এবং প্রোডাকশন অ্যাকাউন্ট
উন্নয়নের উদ্দেশ্যে টেস্ট অ্যাকাউন্ট পাওয়া যায়। টেস্ট অ্যাকাউন্টের মাধ্যমে আপনি যাচাই করতে পারেন যে আপনার অ্যাপ্লিকেশন কোড এবং কনফিগারেশন উদ্দেশ্য অনুযায়ী কাজ করছে কিনা।
তবে, টেস্ট অ্যাকাউন্টে সব ফিচার পরীক্ষা করা সম্ভব নয় ।
যখন টেস্ট অ্যাকাউন্টের সীমাবদ্ধতার কারণে আপনি আপনার ইন্টিগ্রেশনের কিছু ফিচার পরীক্ষা করতে পারেন না, তখন আপনি ডেভেলপমেন্টের জন্য একটি প্রোডাকশন অ্যাকাউন্ট ব্যবহার করতে পারেন। একটি প্রোডাকশন অ্যাকাউন্ট কল করার জন্য আপনার Google Cloud প্রজেক্টে অবশ্যই কমপক্ষে Explorer অ্যাক্সেস লেভেল (Explorer, Basic, বা Standard) থাকতে হবে। মনে রাখবেন যে Explorer অ্যাক্সেস এখনও কিছু নির্দিষ্ট পরিষেবা সীমাবদ্ধ করে—যার মধ্যে রয়েছে বিলিং ( BillingSetupService এবং AccountBudgetProposalService ), প্ল্যানিং, অ্যাকাউন্ট তৈরি, এবং ব্যবহারকারীর আমন্ত্রণ ( Explorer ফিচার সীমাবদ্ধতা দেখুন)—যেগুলোর জন্য Basic বা Standard অ্যাক্সেস প্রয়োজন। v25 থেকে শুরু করে, Test অ্যাক্সেস লেভেলযুক্ত একটি প্রজেক্ট থেকে প্রোডাকশন অ্যাকাউন্ট কল করার চেষ্টা করলে AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION , অথবা v24 এবং তার আগের সংস্করণগুলোতে AuthorizationError.ACTION_NOT_PERMITTED দেখা দেয়।
ডেভেলপমেন্টের জন্য ব্যবহৃত প্রোডাকশন অ্যাকাউন্টগুলো টেস্ট অ্যাকাউন্ট থেকে নিম্নলিখিত দিকগুলোতে ভিন্ন:
- এমন বিজ্ঞাপন পরিবেশন করুন যা ব্যবহারকারীরা দেখতে পারেন।
- বৈধ URL প্রয়োজন
- বিজ্ঞাপন নীতিমালা অবশ্যই মেনে চলতে হবে।
যেহেতু প্রোডাকশন অ্যাকাউন্টগুলো বিজ্ঞাপন পরিবেশন করে, তাই এগুলো এমন মেট্রিক্স তৈরি করে যা আপনাকে পারফরম্যান্স রিপোর্ট পরীক্ষা করার সুযোগ দেয় এবং সেই সাথে গুগল অ্যাডস এপিআই-এর অন্যান্য সমস্ত ফিচারও আনলক করে। তবে, ডেভেলপমেন্টের জন্য এগুলো ব্যবহার করতে অতিরিক্ত সতর্কতা প্রয়োজন। আমরা নিম্নলিখিত পদক্ষেপগুলো নেওয়ার পরামর্শ দিচ্ছি:
- শুধুমাত্র উন্নয়নমূলক কাজের জন্য প্রয়োজন এমন ব্যবহারকারীদেরই প্রবেশাধিকার দিন।
- একটি নির্দিষ্ট ও কম দৈনিক অ্যাকাউন্ট বাজেট নির্ধারণ করুন।
- শুধুমাত্র যখন টেস্ট অ্যাকাউন্ট ব্যবহার করা সম্ভব নয়, তখনই ডেভেলপমেন্টের জন্য প্রোডাকশন অ্যাকাউন্ট ব্যবহার করুন।
সুতরাং, আপনার ইন্টিগ্রেশনের সম্পূর্ণ টেস্টিং করার জন্য সম্ভবত টেস্ট ক্রেডেনশিয়াল এবং প্রোডাকশন ক্রেডেনশিয়াল উভয়েরই প্রয়োজন হবে।
পরীক্ষার প্রমাণপত্র
ডেভেলপমেন্ট অ্যাকাউন্ট পরিবর্তন করার চেষ্টা করার সময় ভুলবশত প্রোডাকশন অ্যাকাউন্ট পরিবর্তন হয়ে যাওয়ার ঝুঁকি কমানোর জন্য, আমরা আপনার প্রোডাকশন অ্যাপ্লিকেশন ক্রেডেনশিয়াল থেকে আলাদা এক সেট টেস্ট ক্রেডেনশিয়াল বজায় রাখার পরামর্শ দিই।
পরীক্ষার ক্রেডেনশিয়াল সেট তৈরি করতে, এই ধাপগুলো অনুসরণ করুন:
- একটি ইমেল অ্যাকাউন্ট (যেমন,
api.test@example.com) অথবা একটি সার্ভিস অ্যাকাউন্ট তৈরি করুন যা শুধুমাত্র পরীক্ষার উদ্দেশ্যে ব্যবহার করা হবে। - আপনি যে Google Ads অ্যাকাউন্টগুলিতে পরীক্ষা চালাচ্ছেন, সেগুলিতে এই ব্যবহারকারী বা পরিষেবা অ্যাকাউন্টটিকে একজন বৈধ ব্যবহারকারী হিসেবে যুক্ত করুন। নিশ্চিত করুন যে আপনি এই ব্যবহারকারী বা পরিষেবা অ্যাকাউন্টটিকে যথাযথ অ্যাক্সেস লেভেল দিয়েছেন। এই ব্যবহারকারী বা পরিষেবা অ্যাকাউন্টটিকে কোনো প্রোডাকশন অ্যাকাউন্টে অ্যাক্সেস দেবেন না।
- আপনি যদি সার্ভিস অ্যাকাউন্ট ফ্লো-এর পরিবর্তে OAuth 2.0 ইউজার অথেন্টিকেশন ফ্লো ব্যবহার করেন, তাহলে আপনার টেস্ট ইউজার অ্যাকাউন্টের জন্য একটি রিফ্রেশ টোকেন জেনারেট করুন।
- আপনার অ্যাপ্লিকেশন পরীক্ষা করার সময় এই নতুন ক্রেডেনশিয়ালগুলো ব্যবহার করুন। ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট পরীক্ষার উদ্দেশ্যে পুনরায় ব্যবহার করা যেতে পারে, কারণ কোন গুগল অ্যাডস অ্যাকাউন্টগুলো অ্যাক্সেস করা যাবে তা নির্ধারণে এগুলোর কোনো প্রভাব নেই। সমস্ত ক্রেডেনশিয়াল এবং রিফ্রেশ টোকেন নিরাপদে সংরক্ষণ করুন এবং কখনোই সোর্স কন্ট্রোলে সেগুলো কমিট করবেন না।
অনুরোধ যাচাইকরণ
যদি আপনার শুধু কোনো অনুরোধ বৈধ কিনা তা পরীক্ষা করার প্রয়োজন হয়—উদাহরণস্বরূপ, অনুরোধটি সঠিকভাবে গঠিত হয়েছে এবং নীতিমালা লঙ্ঘন করছে না তা যাচাই করতে—তাহলে আপনি validate_only ফিল্ডটি ব্যবহার করতে পারেন, যা GoogleAdsService.Search অনুরোধ (উল্লেখ্য যে GoogleAdsService.SearchStream validate_only সমর্থন করে না) এবং বেশিরভাগ mutate অনুরোধের জন্য উপলব্ধ। কোনো নির্দিষ্ট মেথডের জন্য এই ফিল্ডটি উপলব্ধ আছে কিনা তা যাচাই করতে রেফারেন্স ডকুমেন্টেশন দেখুন।
REST API
অ্যাড-হক টেস্টিংয়ের জন্য, যেমন কোনো অনুরোধ প্রত্যাশিত আউটপুট দিচ্ছে কিনা তা যাচাই করতে, REST API ব্যবহার করাই প্রায়শই সবচেয়ে সহজ উপায়। REST API-তে অনুরোধ পাঠানোর জন্য কীভাবে curl ব্যবহার করতে হয় তা শিখতে REST উদাহরণগুলো দেখুন। এছাড়াও, REST এক্সপ্লোরারে পরীক্ষা করে দেখতে পারেন।