ভার্সনিং

কিছু Business Profile API একাধিক ভার্সন ও রিলিজ চ্যানেলে উপলভ্য। ভার্সন হল অনুরোধ URL-এর সেই অংশ যা হোস্টনেমের পরে থাকে, যেমন v1 বা v1alpha। এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে যে কীভাবে ভার্সনের নম্বর দেওয়া হয়, প্রতিটি রিলিজ চ্যানেল কতটা স্টেবল এবং কীভাবে আলফা চ্যানেল কল করতে হয়।

ভার্সন নম্বরিং

প্রতিটি API ভার্সনে একটি মেজর ভার্সন নম্বর এবং একটি ঐচ্ছিক চ্যানেল সাফিক্স থাকে:

• মেজর ভার্সন (v1, v2, ...): একটি স্টেবল, সাধারণত উপলভ্য ভার্সন। মেজর ভার্সনে শুধু ব্যাকওয়ার্ড কম্প্যাটিবল পরিবর্তন করা হয়, যেমন নতুন পদ্ধতি, নতুন ফিল্ড বা নতুন enum ভ্যালু। ব্যাকওয়ার্ড কম্প্যাটিবল নয় এমন পরিবর্তনগুলি নতুন মেজর ভার্সনে রিলিজ করা হয়।
• আলফা চ্যানেল (v1alpha, v2alpha, ...): মেজর ভার্সনের প্রি-রিলিজ চ্যানেল। এতে সেই মেজর ভার্সনের সব কিছু এবং এমন ফিচার অন্তর্ভুক্ত থাকে যা এখনও জেনেরাল অ্যাভেইলেবিলিটিতে পৌঁছায়নি।

রিলিজের চ্যানেল

ফিচার কীভাবে এক চ্যানেল থেকে অন্য চ্যানেলে সরানো হয়

কোনও ফিচার v1alpha থেকে v1-এ আপগ্রেড করা হলে, সেটি v1alpha-এ উপলভ্য থাকে।

শুধুমাত্র v1alpha-এ উপলভ্য ফিচারের জন্য গাইড ও রেফারেন্স পৃষ্ঠা আলফা হিসেবে চিহ্নিত করা হয়। নতুন আলফা ও সাধারণত উপলভ্য ফিচার এবং আলফা ফিচারে পরিবর্তন বা তা সরিয়ে দেওয়ার মতো বিষয়গুলি লেটেস্ট আপডেট এবং প্রতিটি API-এর জন্য পরিবর্তনের লগে ঘোষণা করা হয়।

আলফা চ্যানেল ব্যবহার করুন

আলফা চ্যানেল কল করতে, অনুরোধের URL-এ v1-এর পরিবর্তে v1alpha লিখুন। যেমন:

GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}?readMask={readMask}

দুটি চ্যানেলই একই API-এর অন্তর্গত, তাই তারা নিম্নলিখিতগুলি শেয়ার করে:

• Google Cloud কনসোলে API চালু করা।
• OAuth 2.0 স্কোপ ও অ্যাক্সেস সংক্রান্ত প্রয়োজনীয়তা।
• রিসোর্সের নাম, যেমন locations/{locationId}।
• কোটা। v1 এবং v1alpha-এ করা অনুরোধ একই প্রোজেক্ট-প্রতি কোটার বিরুদ্ধে গণনা করা হয়। আরও জানতে, কোটার সীমা দেখুন।
• অন্তর্নিহিত ব্যবসার ডেটা। v1alpha-এর মাধ্যমে আপনি যেসব পরিবর্তন করেন, সেগুলি v1-এর মাধ্যমে দেখা যায় এবং এর উল্টোটাও হয়।

v1 এবং v1alpha দুটিই পাবলিক API ডিরেক্টরিতে তালিকাভুক্ত করা আছে।

পেশাদার পদ্ধতি

• প্রোডাকশন ইন্টিগ্রেশনের জন্য স্টেবল ভার্সন ব্যবহার করুন, যেমন v1।
• নতুন ফিচার সর্বজনীনভাবে উপলভ্য হওয়ার আগে সেগুলি ব্যবহার করতে, v1alpha-এর মতো আলফা চ্যানেল ব্যবহার করুন। মতামত শেয়ার করতে, সহায়তা দেখুন।
• আপনার ক্লায়েন্টকে এমন ফিল্ড ও enum ভ্যালু সহ্য করতে দিন যা এটি শনাক্ত করতে পারে না।
• আলফা ফিচারের উপর ভিত্তি করে কিছু তৈরি করার আগে, পরিচিত সীমাবদ্ধতার জন্য এর নির্দেশিকা এবং পরিবর্তন লগ চেক করুন।