সেম্যান্টিক ভার্সনিং
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) অটোমেটিক আপডেট হয়ে যায়। নির্দিষ্ট কোনও মেজর ভার্সনে করা সব API কল সবসময় সংশ্লিষ্ট লেটেস্ট মাইনর ভার্সনে যায় এবং Google Ads API নির্দিষ্ট মাইনর ভার্সনে কল করার সুবিধা দেয় না।
আপনার এন্ডপয়েন্ট URL-এ ভার্সন পাথ পরিবর্তন করার প্রয়োজন নেই এবং আগে থেকে থাকা
কোড কোনও সমস্যা ছাড়াই কাজ করতে থাকবে। মাইনর ভার্সনের লাইফস্প্যান আলাদাভাবে
ট্র্যাক করা হয় না। পরিবর্তে, মাইনর ভার্সনগুলি তাদের সংশ্লিষ্ট মেজর ভার্সনের মতো একই সানসেট তারিখ শেয়ার করে।
মাইনর ভার্সন এমন ফিচার বা আপডেট যোগ করে যা আপনার আগে থেকে থাকা কোডকে প্রভাবিত করে না। ক্লায়েন্ট লাইব্রেরি-এর সাথে মাইনর ভার্সনের ফিল্ড বা ফিচার ব্যবহার করতে, আপনার ক্লায়েন্ট লাইব্রেরি এমন একটি রিলিজে আপগ্রেড করুন যাতে মাইনর ভার্সনের সংজ্ঞা অন্তর্ভুক্ত থাকে।
বন্ধ করা ও বন্ধ করার প্রক্রিয়া
Google Ads API যেকোনও সময় একাধিক অ্যাক্টিভ মেজর ভার্সন বজায় রাখে। নির্দিষ্ট সময় অন্তর, আগের ভার্সনগুলি বন্ধ করা হয় এবং পরে সানসেট করা হয়:
- বন্ধ করা হয়েছে: কোনও ভার্সন বন্ধ করা হয়েছে বলে তখনই বিবেচনা করা হয় যখন এটি স্পষ্টভাবে বন্ধ করা হয়েছে বলে চিহ্নিত করা হয়। বন্ধ হয়ে যাওয়া ভার্সনে API কল, সেটির বন্ধ হওয়ার তারিখ পর্যন্ত কাজ করা চালিয়ে যাবে।
- সানসেট: সানসেট তারিখে কোনও ভার্সন বন্ধ করে দেওয়া হয় এবং এর এন্ডপয়েন্টে করা সব API কল ব্যর্থ হয়।
কোনও ভার্সন বন্ধ করার আগে আমরা ডেভেলপার ব্লগে ঘোষণা পোস্ট করি। অ্যাক্টিভ, বন্ধ হয়ে যাওয়া এবং বন্ধ হওয়ার শিডিউল করা তারিখের জন্য বন্ধ হয়ে যাওয়া এবং বন্ধ হওয়ার শিডিউল চেক করুন।