এই নির্দেশিকাটি গুগল চ্যাট এপিআই-এর Space রিসোর্সের list() ব্যবহার করে স্পেসগুলির তালিকা তৈরি করার পদ্ধতি ব্যাখ্যা করে। স্পেসগুলির তালিকা তৈরি করলে একটি পেজিনেটেড ও ফিল্টারযোগ্য তালিকা ফেরত আসে।
Space রিসোর্স হলো এমন একটি স্থান যেখানে ব্যক্তি এবং চ্যাট অ্যাপগুলো বার্তা পাঠাতে, ফাইল শেয়ার করতে এবং একসাথে কাজ করতে পারে। বিভিন্ন ধরনের স্পেস রয়েছে:
- ডাইরেক্ট মেসেজ (ডিএম) হলো দুইজন ব্যবহারকারীর মধ্যে অথবা একজন ব্যবহারকারী ও একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
- গ্রুপ চ্যাট হলো তিন বা ততোধিক ব্যবহারকারীর মধ্যে চ্যাট অ্যাপে হওয়া কথোপকথন।
- নেমড স্পেস হলো এমন স্থায়ী স্থান যেখানে মানুষ বার্তা পাঠায়, ফাইল শেয়ার করে এবং সম্মিলিতভাবে কাজ করে।
অ্যাপ অথেন্টিকেশন সহ স্পেসের তালিকা করলে সেইসব স্পেসের তালিকা পাওয়া যায় যেগুলিতে চ্যাট অ্যাপের অ্যাক্সেস আছে। ইউজার অথেন্টিকেশন সহ স্পেসের তালিকা করলে সেইসব স্পেসের তালিকা পাওয়া যায় যেগুলিতে অথেন্টিকেটেড ইউজারের অ্যাক্সেস আছে।
পূর্বশর্ত
নোড.জেএস
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
পাইথন
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
জাভা
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার গুগল চ্যাট এপিআই অনুরোধে আপনি যেভাবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো
credentials.jsonনামের একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণের জন্য, OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল তৈরি করুন এবং ক্রেডেনশিয়ালগুলো আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।
- আপনার পরিবেশ প্রস্তুত করুন:
- একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন ।
- OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ দিয়ে গুগল চ্যাট এপিআই সক্রিয় ও কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি করুন এবং অ্যাডভান্সড চ্যাট সার্ভিসটি চালু করুন।
- এই নির্দেশিকায়, আপনাকে অবশ্যই ব্যবহারকারী অথবা অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণের জন্য, পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল তৈরি করুন। ধাপগুলোর জন্য, ‘গুগল চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ ও অনুমোদন’ দেখুন।
- আপনি ব্যবহারকারী হিসেবে নাকি চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে চান, তার উপর ভিত্তি করে অনুমোদনের পরিধি বেছে নিন ।
ব্যবহারকারী প্রমাণীকরণ সহ তালিকা স্থান
গুগল চ্যাটে খালি জায়গা তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতগুলি উল্লেখ করুন:
- ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে,
chat.spaces.readonlyঅথবাchat.spacesঅনুমোদন পরিধি নির্দিষ্ট করুন। -
ListSpaces()মেথডটি কল করুন।
নিম্নলিখিত উদাহরণটি প্রমাণীকৃত ব্যবহারকারীর কাছে দৃশ্যমান নামযুক্ত স্পেসগুলির তালিকা দেখায় (তবে গ্রুপ চ্যাট এবং সরাসরি বার্তাগুলি নয়, যেগুলি ফিল্টার করে বাদ দেওয়া হয়েছে):
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
চ্যাট এপিআই স্পেসগুলির একটি পেজিনেটেড তালিকা ফেরত দেয়।
অ্যাপ প্রমাণীকরণের সাথে তালিকাভুক্ত স্থানগুলি
গুগল চ্যাটে খালি জায়গা তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতগুলি উল্লেখ করুন:
- অ্যাপ অথেনটিকেশনের ক্ষেত্রে,
chat.botঅথরাইজেশন স্কোপ নির্দিষ্ট করুন। -
ListSpaces()মেথডটি কল করুন।
নিম্নলিখিত উদাহরণটিতে চ্যাট অ্যাপের জন্য দৃশ্যমান নামযুক্ত স্পেসগুলির তালিকা দেওয়া হয়েছে (তবে গ্রুপ চ্যাট এবং সরাসরি বার্তা নয়):
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
চ্যাট এপিআই স্পেসগুলির একটি পেজিনেটেড তালিকা ফেরত দেয়।
পেজিনেশন কাস্টমাইজ করুন অথবা তালিকাটি ফিল্টার করুন
গুগল চ্যাটে স্পেস তালিকাভুক্ত করতে, পেজিনেশন কাস্টমাইজ করতে বা তালিকাভুক্ত স্পেস ফিল্টার করতে নিম্নলিখিত ঐচ্ছিক কোয়েরি প্যারামিটারগুলো পাস করুন:
-
pageSize: ফেরত দেওয়া স্পেসের সর্বোচ্চ সংখ্যা। সার্ভিসটি এই মানের চেয়ে কমও ফেরত দিতে পারে। যদি নির্দিষ্ট না করা হয়, তবে সর্বাধিক ১০০টি স্পেস ফেরত দেওয়া হয়। সর্বোচ্চ মান হলো ১,০০০; ১,০০০-এর বেশি মান স্বয়ংক্রিয়ভাবে ১,০০০-এ পরিবর্তিত হয়ে যায়। -
pageToken: একটি পেজ টোকেন, যা পূর্ববর্তী লিস্ট স্পেস কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন। পেজিনেশন করার সময়, ফিল্টার মানটি অবশ্যই সেই কলের সাথে মিলতে হবে যেখান থেকে পেজ টোকেনটি প্রদান করা হয়েছিল। ভিন্ন কোনো মান দিলে অপ্রত্যাশিত ফলাফল হতে পারে। -
filter: একটি কোয়েরি ফিল্টার। সমর্থিত কোয়েরির বিস্তারিত তথ্যের জন্য,ListSpacesRequestরেফারেন্স দেখুন।
সম্পর্কিত বিষয়
- একটি জায়গা তৈরি করুন ।
- একটি জায়গা প্রস্তুত করুন ।
- একটি স্থান সম্পর্কে বিস্তারিত জানুন ।
- একটি স্থান হালনাগাদ করুন ।
- একটি স্পেস মুছে দিন ।
- সরাসরি বার্তা পাঠানোর একটি জায়গা খুঁজুন ।