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