কিছু Business Profile API একাধিক ভার্সন ও রিলিজ চ্যানেলে
উপলভ্য। ভার্সন হল অনুরোধের URL-এর সেই অংশ যা হোস্টনেমের পরে থাকে, যেমন v1 বা v1alpha। এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে ভার্সনের নম্বর দেওয়া হয়, প্রতিটি রিলিজ চ্যানেল কতটা স্টেবল এবং কীভাবে আলফা চ্যানেল কল করতে হয়।
ভার্সন নম্বরিং
প্রতিটি API ভার্সনে একটি মেজর ভার্সন নম্বর এবং একটি ঐচ্ছিক চ্যানেল সাফিক্স থাকে:
- মেজর ভার্সন (
v1,v2, ...): একটি স্টেবল, সাধারণত উপলভ্য ভার্সন। মেজর ভার্সনে শুধু ব্যাকওয়ার্ড কম্প্যাটিবল পরিবর্তন করা হয়, যেমন নতুন পদ্ধতি, নতুন ফিল্ড বা নতুন enum ভ্যালু। ব্যাকওয়ার্ড কম্প্যাটিবল নয় এমন পরিবর্তনগুলি নতুন মেজর ভার্সনে রিলিজ করা হয়। - আলফা চ্যানেল (
v1alpha,v2alpha, ...): কোনও মেজর ভার্সনের প্রি-রিলিজ চ্যানেল। এতে সেই মেজর ভার্সনের সবকিছু এবং এমন ফিচার অন্তর্ভুক্ত থাকে যা এখনও জেনেরাল অ্যাভেইলেবিলিটিতে পৌঁছায়নি।
রিলিজের চ্যানেল
| চ্যানেল | স্থায়িত্ব | কন্টেন্ট |
|---|---|---|
জেনেরাল অ্যাভেইলেবিলিটি (v1) |
স্থিতিশীল। মেজর ভার্সনের মধ্যে করা পরিবর্তন ব্যাকওয়ার্ড কম্প্যাটিবল। কোনও মেজর ভার্সন বন্ধ করে দেওয়া হলে, বন্ধ করার ঘোষণা করার পরে অন্তত ১২ মাস পর্যন্ত সেটি উপলভ্য থাকে। বন্ধ হয়ে যাওয়া এবং বন্ধ হওয়ার তারিখ বন্ধ হওয়ার শিডিউল পৃষ্ঠায় প্রকাশ করা হয়। | সাধারণত উপলভ্য ফিচার। |
আলফা (v1alpha) |
প্রি-রিলিজ, কোনও স্থায়িত্বের প্রতিশ্রুতি এবং নির্দিষ্ট লাইফস্প্যান নেই। কমপক্ষে ৩০ দিনের নোটিশ দিয়ে আলফা ফিচার পরিবর্তন বা বন্ধ করা হতে পারে। প্রোডাকশন ইন্টিগ্রেশনে আলফা ফিচার ব্যবহার করবেন না। | v1-এর সব কিছু, সাথে এমন ফিচার যা এখনও জেনেরাল অ্যাভেইলেবিলিটিতে পৌঁছায়নি। |
ফিচার কীভাবে এক চ্যানেল থেকে অন্য চ্যানেলে সরানো হয়
কোনও ফিচার 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-এর মাধ্যমে দেখা যায় এবং এর উল্টোটাও হয়।
ক্লায়েন্ট লাইব্রেরি এবং পাবলিক API ডিরেক্টরিতে শুধু v1 অন্তর্ভুক্ত থাকে। v1alpha-কে কল করতে, সরাসরি REST অনুরোধ পাঠান।
পেশাদার পদ্ধতি
- প্রোডাকশন ইন্টিগ্রেশনের জন্য স্টেবল ভার্সন ব্যবহার করুন, যেমন
v1। - নতুন ফিচার সর্বজনীনভাবে উপলভ্য হওয়ার আগে সেগুলি ব্যবহার করতে,
v1alpha-এর মতো আলফা চ্যানেল ব্যবহার করুন। মতামত শেয়ার করতে, সহায়তা দেখুন। - আপনার ক্লায়েন্টকে এমন ফিল্ড ও enum ভ্যালু সহ্য করতে দিন যা এটি চিনতে পারে না।
- আলফা ফিচারের উপর ভিত্তি করে কিছু তৈরি করার আগে, পরিচিত সীমাবদ্ধতার জন্য এর নির্দেশিকা এবং পরিবর্তন লগ চেক করুন।