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