শব্দার্থিক সংস্করণ
গুগল অ্যাডস এপিআই সিমান্টিক ভার্সনিং অনুসরণ করে, যেখানে একটি মেজর এবং একটি মাইনর ভার্সন থাকে। ভার্সনের ফরম্যাটটি হলো MAJOR.MINOR বা vMAJOR_MINOR । উদাহরণস্বরূপ, v24_0 হলো একটি মেজর ভার্সন, আর v24_1 হলো একটি মাইনর ভার্সন।
পূর্ববর্তী সংস্করণগুলোর রিলিজ নোট দেখুন।
প্রধান সংস্করণ
প্রধান রিলিজ সংস্করণগুলিতে কিছু বড় ধরনের ও পূর্ববর্তী সংস্করণের সাথে অসামঞ্জস্যপূর্ণ পরিবর্তন আনা হয়। সংস্করণটির শেষে শূন্য থাকবে এবং এর ফরম্যাট হবে vX_0 , যেখানে X হলো প্রধান সংস্করণ নম্বর।
প্রতিটি প্রধান সংস্করণের একটি আলাদা এন্ডপয়েন্ট থাকে। এই উদাহরণ URL-টিতে, X হলো প্রধান সংস্করণ নম্বর।
https://googleads.googleapis.com/vX
আপনি যদি পুরোনো কোনো প্রধান সংস্করণ থেকে আপগ্রেড করেন, তাহলে নতুন প্রধান সংস্করণের এন্ডপয়েন্টে পরিবর্তন করার সময় আপনার কোডে পরিবর্তনের প্রয়োজন হতে পারে। আপনি যদি আমাদের ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে সর্বশেষ সংস্করণে আপগ্রেড করুন। যখন কোনো প্রধান সংস্করণ প্রকাশিত হবে, আমরা একটি মাইগ্রেশন গাইড প্রদান করব, যা অনুসরণ করে আপনি আপনার কোডের যেকোনো ব্রেকিং চেঞ্জ ঠিক করতে পারবেন।
ব্রেকিং চেঞ্জের উদাহরণগুলো হলো:
- কোনো সার্ভিস, ইন্টারফেস, ফিল্ড, মেথড বা এনাম ভ্যালু অপসারণ বা পুনঃনামকরণ করা।
- ফিল্ডের ধরন পরিবর্তন করা।
- রিসোর্সের নামের ফরম্যাট পরিবর্তন করা।
- HTTP সংজ্ঞায় URL ফরম্যাট পরিবর্তন করা।
- আউটপুট ফরম্যাট পরিবর্তন করা, যেমন ডিফল্ট মান হিসেবে
0থেকে--এ পরিবর্তন করা। - ত্রুটির কারণ পরিবর্তন করার ফলে প্রাপ্ত মান A থেকে B-তে পরিবর্তিত হয়েছে।
ছোট সংস্করণ
মাইনর ভার্সন শুধুমাত্র ব্যাকওয়ার্ড-কম্প্যাটিবল পরিবর্তন নিয়ে আসে। একটি মাইনর ভার্সনের ক্ষেত্রে, vMAJOR_MINOR MINOR নম্বরটি শূন্য অপেক্ষা বড় হবে।
যখন কোনো মাইনর ভার্সন রিলিজ করা হবে, তখন ইতিমধ্যে ব্যবহৃত এন্ডপয়েন্টটি স্বয়ংক্রিয়ভাবে আপডেট হয়ে যাবে। এর কারণে আপনার কোডে কোনো সমস্যা হবে না। আপনি আপনার বিদ্যমান ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করা চালিয়ে যেতে পারেন।
মাইনর ভার্সনগুলোতে এমন নতুন ফিচার বা আপডেট থাকে যা আপনার বিদ্যমান কোডকে প্রভাবিত করে না। আপনি যদি এই নতুন ফিচারগুলো ব্যবহার করতে চান, তাহলে আপনার ক্লায়েন্ট লাইব্রেরিগুলোকে সর্বশেষ ভার্সনে আপগ্রেড করুন।
সূর্যাস্ত
নির্দিষ্ট সময় পর পর, গুগল অ্যাডস এপিআই-এর পুরোনো সংস্করণগুলো বন্ধ করে দেওয়ার প্রয়োজন হবে। কোনো সংস্করণ বন্ধ হওয়ার সময় হলে আমরা ডেভেলপার ব্লগে বিজ্ঞপ্তি প্রকাশ করব। ভবিষ্যতে সংস্করণ বন্ধ হওয়ার তারিখগুলো দিয়ে এই বাতিলকরণ সময়সূচীটি হালনাগাদ করা হয়।