এই পৃষ্ঠায় গুগল চ্যাট এপিআই ব্যবহারের পদ্ধতি এবং এর রেফারেন্স ডকুমেন্টেশন সম্পর্কে একটি সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে।
গুগল চ্যাট এপিআই-এর gRPC এবং REST উভয় ইন্টারফেসই রয়েছে, এবং উভয়কেই সমর্থন করে এমন ক্লায়েন্ট লাইব্রেরিও আছে। ঐচ্ছিকভাবে, যদি প্রদত্ত ক্লায়েন্ট লাইব্রেরিগুলো আপনার প্রয়োজন মেটাতে না পারে, তবে আপনি gRPC বা REST ইন্টারফেস ব্যবহার করে আপনার নিজস্ব ক্লায়েন্ট লাইব্রেরি লিখতে পারেন।
ক্লায়েন্ট লাইব্রেরি
বেশিরভাগ ডেভেলপারদের জন্য গুগল চ্যাট এপিআই কল করার প্রস্তাবিত উপায় হলো, আপনার পছন্দের ভাষা, যেমন পাইথন, জাভা বা নোড.জেএস-এর জন্য আমাদের আনুষ্ঠানিকভাবে সমর্থিত ক্লাউড ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করা।
আপনি যদি গুগল অ্যাপস স্ক্রিপ্ট দিয়ে কোডিং করেন, তাহলে ক্লায়েন্ট লাইব্রেরি ইনস্টল করার পরিবর্তে অ্যাডভান্সড চ্যাট পরিষেবাটি ব্যবহার করুন।
টাইপ, মেথড এবং ফিল্ডের নাম
আপনি ক্লায়েন্ট লাইব্রেরি, gRPC, বা REST ব্যবহার করছেন কিনা তার উপর নির্ভর করে Google Chat API-এর টাইপ, মেথড এবং ফিল্ডের নাম কিছুটা ভিন্ন হয়:
- ক্লাউড ক্লায়েন্ট লাইব্রেরিগুলো gRPC পরিষেবা এবং তাদের মেথড অনুসারে সাজানো থাকে। গুগল এপিআই ক্লায়েন্ট লাইব্রেরিগুলো পরিষেবা হিসেবে সাজানো থাকে, যেগুলোতে REST রিসোর্সের সাথে সঙ্গতিপূর্ণ অবজেক্ট বা ক্লাস থাকে, এবং সেই রিসোর্সগুলোতে সংশ্লিষ্ট মেথডও থাকে।
- gRPC পরিষেবা এবং তাদের পদ্ধতি অনুসারে বিন্যস্ত করা হয়।
- REST রিসোর্স স্তরবিন্যাস এবং তাদের মেথড অনুসারে সাজানো হয়।
- gRPC ফিল্ডের নামগুলো স্নেক কেসে ব্যবহার করা হয়।
- REST ফিল্ডের নামগুলো ক্যামেল কেস ব্যবহার করে, যদিও API পরিষেবাটি ক্যামেল কেস বা স্নেক কেস উভয়ই গ্রহণ করে।
- ক্লায়েন্ট লাইব্রেরির ফিল্ডের নামগুলো টাইটেল কেস, ক্যামেল কেস বা স্নেক কেস ব্যবহার করে, যা ভাষার জন্য প্রচলিত নামের উপর নির্ভর করে।
প্রোটোকল বাফার
আপনি ক্লায়েন্ট লাইব্রেরি, REST বা gRPC যা-ই ব্যবহার করুন না কেন, অন্তর্নিহিত পরিষেবাটি প্রোটোকল বাফার ব্যবহার করে সংজ্ঞায়িত করা হয়। বিশেষত, পরিষেবাটি proto3 ব্যবহার করে।
এপিআই কল করার সময়, কিছু অনুরোধ বা প্রতিক্রিয়া ফিল্ডের জন্য প্রোটোকল বাফার সুপরিচিত প্রকারগুলি সম্পর্কে প্রাথমিক ধারণা থাকার প্রয়োজন হতে পারে।
এছাড়াও, REST API কল করার সময়, প্রোটোকল বাফারের ডিফল্ট ভ্যালু ব্যবহারের কারণে JSON রেসপন্সে কিছু ফিল্ড বাদ পড়তে পারে। এই ফিল্ডগুলো ডিফল্ট ভ্যালুতে সেট করা থাকে, তাই সেগুলো রেসপন্সে অন্তর্ভুক্ত হয় না।
এপিআই সংস্করণ
নিম্নলিখিত API সংস্করণগুলি উপলব্ধ আছে:
- v1 : স্থিতিশীল।
ডেভেলপার প্রিভিউ
ডকুমেন্টেশনে আপনি এমন কিছু API মেথড বা ফিল্ড দেখতে পারেন, যা শুধুমাত্র ডেভেলপার প্রিভিউ প্রোগ্রামের মাধ্যমে পাওয়া যায়। সর্বশেষ প্রিভিউ ফিচারগুলো পরীক্ষা ও প্রিভিউ করতে এবং সেগুলোর উপর মতামত জানাতে, ডেভেলপার প্রিভিউ প্রোগ্রামে যোগদান করুন।