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