সেম্যান্টিক ভার্সনিং
Google Ads API-তে মেজর ও মাইনর ভার্সন নম্বর সহ সিম্যান্টিক ভার্সনিং
ব্যবহার করা হয়। ভার্সন MAJOR.MINOR বা vMAJOR.MINOR হিসেবে লেখা হয়।
যেমন, v26.0 (বা v26) হল মেজর
ভার্সন, যেখানে v26.1 হল মাইনর ভার্সন।
বর্তমান ও আগের ভার্সন সম্পর্কে বিস্তারিত জানতে রিলিজ নোট দেখুন।
মেজর ভার্সন
মেজর রিলিজ ভার্সন ব্রেকিং, ব্যাকওয়ার্ড-ইনকমপ্যাটিবল পরিবর্তন নিয়ে আসে। মেজর ভার্সনের
প্রাথমিক রিলিজের শেষে শূন্য থাকে (vX.0, বা vX, যেখানে X হল
মেজর ভার্সন নম্বর)।
প্রতিটি মেজর ভার্সনের আলাদা REST এবং gRPC এন্ডপয়েন্ট পাথ (vX) থাকে, যার মধ্যে
মাইনর ভার্সন সাফিক্স থাকে না। নিম্নলিখিত URL-এ, X হল মেজর
ভার্সন নম্বর (যেমন, v26):
https://googleads.googleapis.com/vX
আপনি যদি কোনও পুরনো মেজর ভার্সন থেকে আপগ্রেড করেন, তাহলে নতুন মেজর ভার্সন এন্ডপয়েন্টে সুইচ করার সময় আপনার কোডে পরিবর্তন করার প্রয়োজন হতে পারে। আপনি আমাদের ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, ক্লায়েন্ট লাইব্রেরি রিলিজে আপগ্রেড করুন যা নতুন মেজর ভার্সন সাপোর্ট করে। কোনও মেজর ভার্সন রিলিজ করা হলে, আপনার কোডে কোনও ব্রেকিং পরিবর্তন সমাধান করতে সাহায্য করার জন্য আমরা একটি আপগ্রেড গাইড প্রদান করি।
ব্রেকিং পরিবর্তনের উদাহরণের মধ্যে অন্তর্ভুক্ত:
- কোনও পরিষেবা, ইন্টারফেস, ফিল্ড, পদ্ধতি বা enum ভ্যালু সরানো বা নাম পরিবর্তন করা।
- কোনও ফিল্ডের ধরন পরিবর্তন করা।
- রিসোর্স নামের ফর্ম্যাট পরিবর্তন করা হচ্ছে।
- HTTP সংজ্ঞায় URL ফর্ম্যাট পরিবর্তন করা হচ্ছে।
- আউটপুট ফর্ম্যাট পরিবর্তন করা, যেমন ডিফল্ট ভ্যালু পরিবর্তন করা।
- সমস্যার কারণ A থেকে B-তে পরিবর্তন করা হয়েছে।
মাইনর ভার্সন
মাইনর ভার্সনে শুধু ব্যাকওয়ার্ড কম্প্যাটিবল পরিবর্তন করা হয়। মাইনর ভার্সনের ক্ষেত্রে,
vMAJOR.MINOR-এর MINOR নম্বর শূন্যের থেকে বেশি (যেমন,
v26.1)।
মাইনর ভার্সন রিলিজ করা হলে, আগে থেকে থাকা মেজর ভার্সন এন্ডপয়েন্ট
(https://googleads.googleapis.com/vX) অটোমেটিক আপডেট হয়ে যায়। আপনার
এন্ডপয়েন্ট URL-এ ভার্সন পাথ পরিবর্তন করার প্রয়োজন নেই এবং আগে থেকে থাকা কোড
কোনও সমস্যা ছাড়াই কাজ করতে থাকবে।
মাইনর ভার্সন এমন ফিচার বা আপডেট যোগ করে যা আপনার আগে থেকে থাকা কোডকে প্রভাবিত করে না। ক্লায়েন্ট লাইব্রেরি-এর সাথে মাইনর ভার্সনের ফিল্ড বা ফিচার ব্যবহার করতে, আপনার ক্লায়েন্ট লাইব্রেরি এমন একটি রিলিজে আপগ্রেড করুন যাতে মাইনর ভার্সনের সংজ্ঞা অন্তর্ভুক্ত থাকে।
বন্ধ করা ও সূর্যাস্ত
নির্দিষ্ট সময় অন্তর, Google Ads API-এর পুরনো ভার্সন বন্ধ করে দেওয়া হয় এবং পরে তা আর ব্যবহার করা যায় না:
- ডেপ্রিকেটেড: কোনও মেজর ভার্সন (যেমন
v26) রিলিজ করা হলে, আগের সব মেজর ভার্সনকে ডেপ্রিকেটেড হিসেবে চিহ্নিত করা হয়। বন্ধ হয়ে যাওয়া ভার্সনে API কল বন্ধ হওয়ার তারিখ পর্যন্ত কাজ করা চালিয়ে যায় এবং বিদ্যমান ক্লায়েন্ট লাইব্রেরি রিলিজ সেগুলিকে সাপোর্ট করা চালিয়ে যায়, যদিও পরবর্তী ক্লায়েন্ট লাইব্রেরি রিলিজ বন্ধ হয়ে যাওয়া API ভার্সন বাদ দেয় যাতে প্যাকেজের সাইজ কমানো যায়। - সানসেট: সানসেট তারিখে কোনও ভার্সন বন্ধ করে দেওয়া হয় এবং এর এন্ডপয়েন্টে করা সব API কল ব্যর্থ হয়।
কোনও ভার্সন বন্ধ করার আগে আমরা ডেভেলপার ব্লগে ঘোষণা পোস্ট করি। অ্যাক্টিভ, বন্ধ হয়ে যাওয়া এবং বন্ধ হওয়ার শিডিউল করা তারিখের জন্য বন্ধ হয়ে যাওয়া এবং বন্ধ হওয়ার শিডিউল চেক করুন।