এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে একটি Google চ্যাট স্পেস সেট আপ করতে Google Chat API এর Space
রিসোর্সে setUp()
পদ্ধতি ব্যবহার করতে হয়। একটি স্থান সেট আপ করা একটি স্থান তৈরি করে এবং এটিতে নির্দিষ্ট ব্যবহারকারীদের যোগ করে।
Space
রিসোর্স এমন একটি জায়গাকে প্রতিনিধিত্ব করে যেখানে লোকেরা এবং চ্যাট অ্যাপ মেসেজ পাঠাতে, ফাইল শেয়ার করতে এবং সহযোগিতা করতে পারে। বিভিন্ন ধরনের স্পেস আছে:
- ডাইরেক্ট মেসেজ (DMs) হল দুই ব্যবহারকারী বা একজন ব্যবহারকারী এবং একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
- গ্রুপ চ্যাট হল তিন বা ততোধিক ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে কথোপকথন।
- নামযুক্ত স্থানগুলি স্থায়ী স্থান যেখানে লোকেরা বার্তা পাঠায়, ফাইলগুলি ভাগ করে এবং সহযোগিতা করে৷
একটি স্থান সেট আপ করার সময়, নিম্নলিখিত বিবেচনা করুন:
- কলিং (প্রমাণিত) ব্যবহারকারী স্বয়ংক্রিয়ভাবে স্পেসে যুক্ত হয়, তাই আপনাকে অনুরোধে ব্যবহারকারীর সদস্যতা নির্দিষ্ট করতে হবে না।
- একটি সরাসরি বার্তা (DM) তৈরি করার সময়, যদি দুটি ব্যবহারকারীর মধ্যে একটি DM বিদ্যমান থাকে, তাহলে DM ফেরত দেওয়া হয়। অন্যথায়, একটি DM তৈরি করা হয়।
- একটি গ্রুপ চ্যাট তৈরি করার সময়, যদি অনুরোধে প্রদত্ত সদস্যতাগুলির একটিও সফলভাবে গ্রুপ চ্যাটে যোগ করা না হয় (উদাহরণস্বরূপ, অনুমতির সমস্যা), তাহলে একটি খালি গ্রুপ চ্যাট (শুধুমাত্র কলিং ব্যবহারকারী সহ) তৈরি হতে পারে।
- আপনি থ্রেড করা উত্তর দিয়ে স্পেস সেট-আপ করতে পারবেন না বা আপনার Google Workspace-এর বাইরের লোকদের যোগ করতে পারবেন না।
- অনুরোধে প্রদত্ত ডুপ্লিকেট সদস্যতা (কলিং ব্যবহারকারী সহ) অনুরোধ ত্রুটির পরিবর্তে ফিল্টার আউট করা হয়।
পূর্বশর্ত
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
জাভা
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং উন্নত চ্যাট পরিষেবা চালু করুন।
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
একটি স্থান সেট আপ করুন
একটি স্থান সেট আপ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.spaces.create
বাchat.spaces
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
SetUpSpace()
পদ্ধতিতে কল করুন। -
displayName
বাspaceType
এর মতো সমস্ত প্রয়োজনীয় ক্ষেত্রগুলির সাথেSpace
এর উদাহরণ হিসাবেspace
পাস করুন। -
Membership
দৃষ্টান্তের একটি অ্যারে হিসাবেmemberships
পাস. প্রতিটি উদাহরণের জন্য:- একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করার জন্য
users/{user}
নির্দিষ্ট করুন, যেখানে{user}
হয় People API-এরperson
জন্য{person_id}
, অথবা ডিরেক্টরি API-তেuser
আইডি। উদাহরণস্বরূপ, যদি People API personresourceName
হয়people/123456789
, তাহলে আপনিusers/123456789
সাথেmember.name
হিসাবে একটি সদস্যপদ অন্তর্ভুক্ত করে স্পেসে ব্যবহারকারীকে যুক্ত করতে পারেন। - একটি স্পেস সদস্য হিসাবে একটি গ্রুপ যোগ করার জন্য
groups/{group}
নির্দিষ্ট করুন, যেখানে{group}
হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে। উদাহরণস্বরূপ, যদি ক্লাউড আইডেন্টিটি এপিআইgroups/123456789
নামের একটি গ্রুপ ফেরত দেয়, তাহলেmembership.groupMember.name
groups/123456789
এ সেট করুন। Google গোষ্ঠীগুলিকে একটি গ্রুপ চ্যাট বা DM-এ যোগ করা যাবে না, তবে শুধুমাত্র একটি নামযুক্ত স্থানে।
- একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করার জন্য
কলিং ব্যবহারকারী এবং অন্য মানব ব্যবহারকারীর মধ্যে একটি DM তৈরি করতে, আপনার অনুরোধে মানব ব্যবহারকারীর সদস্যতা নির্দিষ্ট করুন।
কলিং ব্যবহারকারী এবং কলিং অ্যাপের মধ্যে একটি DM তৈরি করতে, space.singleUserBotDm
কে true
সেট করুন এবং কোনো সদস্যতা নির্দিষ্ট করবেন না। আপনি শুধুমাত্র কলিং অ্যাপের সাথে একটি DM সেট আপ করতে এই পদ্ধতিটি ব্যবহার করতে পারেন৷ কলিং অ্যাপটিকে একটি স্পেসের সদস্য বা দুটি মানব ব্যবহারকারীর মধ্যে বিদ্যমান DM হিসাবে যোগ করতে, একটি সদস্যতা তৈরি করুন দেখুন।
নিম্নলিখিত উদাহরণটি একটি নামযুক্ত স্থান তৈরি করে এবং দুটি মানব ব্যবহারকারীর (প্রমাণিত ব্যবহারকারী এবং অন্য একজন ব্যবহারকারী) জন্য স্থানটিতে একটি সদস্যতা তৈরি করে।
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
DISPLAY_NAME
: নতুন স্থানের প্রদর্শন নাম। -
USER_NAME
: সদস্যতা অন্তর্ভুক্ত করার জন্য অন্য ব্যবহারকারীর আইডি।
স্পেসে যেতে, স্পেসের ইউআরএল তৈরি করতে স্পেসের রিসোর্স আইডি ব্যবহার করুন। আপনি Google Chat রেসপন্স বডিতে স্পেস name
থেকে রিসোর্স আইডি পেতে পারেন। উদাহরণস্বরূপ, যদি আপনার স্থানের name
হয় spaces/1234567
, তাহলে আপনি নিম্নলিখিত URL ব্যবহার করে স্পেসটিতে যেতে পারেন: https://mail.google.com/chat/u/0/#chat/space/1234567
।
সম্পর্কিত বিষয়
- একটি স্থান তৈরি করুন ।
- একটি স্থান সম্পর্কে বিশদ পান ।
- স্থান তালিকা .
- একটি স্থান আপডেট করুন ।
- একটি স্থান মুছুন ।
- একটি সরাসরি বার্তা স্থান খুঁজুন .
- নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্থান আবিষ্কারযোগ্য করুন ।
এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে একটি Google চ্যাট স্পেস সেট আপ করতে Google Chat API এর Space
রিসোর্সে setUp()
পদ্ধতি ব্যবহার করতে হয়। একটি স্থান সেট আপ করা একটি স্থান তৈরি করে এবং এটিতে নির্দিষ্ট ব্যবহারকারীদের যোগ করে।
Space
রিসোর্স এমন একটি জায়গাকে প্রতিনিধিত্ব করে যেখানে লোকেরা এবং চ্যাট অ্যাপ মেসেজ পাঠাতে, ফাইল শেয়ার করতে এবং সহযোগিতা করতে পারে। বিভিন্ন ধরনের স্পেস আছে:
- ডাইরেক্ট মেসেজ (DMs) হল দুই ব্যবহারকারী বা একজন ব্যবহারকারী এবং একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
- গ্রুপ চ্যাট হল তিন বা ততোধিক ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে কথোপকথন।
- নামযুক্ত স্থানগুলি স্থায়ী স্থান যেখানে লোকেরা বার্তা পাঠায়, ফাইলগুলি ভাগ করে এবং সহযোগিতা করে৷
একটি স্থান সেট আপ করার সময়, নিম্নলিখিত বিবেচনা করুন:
- কলিং (প্রমাণিত) ব্যবহারকারী স্বয়ংক্রিয়ভাবে স্পেসে যুক্ত হয়, তাই আপনাকে অনুরোধে ব্যবহারকারীর সদস্যতা নির্দিষ্ট করতে হবে না।
- একটি সরাসরি বার্তা (DM) তৈরি করার সময়, যদি দুটি ব্যবহারকারীর মধ্যে একটি DM বিদ্যমান থাকে, তাহলে DM ফেরত দেওয়া হয়। অন্যথায়, একটি DM তৈরি করা হয়।
- একটি গ্রুপ চ্যাট তৈরি করার সময়, যদি অনুরোধে প্রদত্ত সদস্যতাগুলির একটিও সফলভাবে গ্রুপ চ্যাটে যোগ করা না হয় (উদাহরণস্বরূপ, অনুমতির সমস্যা), তাহলে একটি খালি গ্রুপ চ্যাট (শুধুমাত্র কলিং ব্যবহারকারী সহ) তৈরি হতে পারে।
- আপনি থ্রেড করা উত্তর দিয়ে স্পেস সেট-আপ করতে পারবেন না বা আপনার Google Workspace-এর বাইরের লোকদের যোগ করতে পারবেন না।
- অনুরোধে প্রদত্ত ডুপ্লিকেট সদস্যতা (কলিং ব্যবহারকারী সহ) অনুরোধ ত্রুটির পরিবর্তে ফিল্টার আউট করা হয়।
পূর্বশর্ত
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
জাভা
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং উন্নত চ্যাট পরিষেবা চালু করুন।
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
একটি স্থান সেট আপ করুন
একটি স্থান সেট আপ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.spaces.create
বাchat.spaces
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
SetUpSpace()
পদ্ধতিতে কল করুন। -
displayName
বাspaceType
এর মতো সমস্ত প্রয়োজনীয় ক্ষেত্রগুলির সাথেSpace
এর উদাহরণ হিসাবেspace
পাস করুন। -
Membership
দৃষ্টান্তের একটি অ্যারে হিসাবেmemberships
পাস. প্রতিটি উদাহরণের জন্য:- একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করার জন্য
users/{user}
নির্দিষ্ট করুন, যেখানে{user}
হয় People API-এরperson
জন্য{person_id}
, অথবা ডিরেক্টরি API-তেuser
আইডি। উদাহরণস্বরূপ, যদি People API personresourceName
হয়people/123456789
, তাহলে আপনিusers/123456789
সাথেmember.name
হিসাবে একটি সদস্যপদ অন্তর্ভুক্ত করে স্পেসে ব্যবহারকারীকে যুক্ত করতে পারেন। - একটি স্পেস সদস্য হিসাবে একটি গ্রুপ যোগ করার জন্য
groups/{group}
নির্দিষ্ট করুন, যেখানে{group}
হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে। উদাহরণস্বরূপ, যদি ক্লাউড আইডেন্টিটি এপিআইgroups/123456789
নামের একটি গ্রুপ ফেরত দেয়, তাহলেmembership.groupMember.name
groups/123456789
এ সেট করুন। Google গোষ্ঠীগুলিকে একটি গ্রুপ চ্যাট বা DM-এ যোগ করা যাবে না, তবে শুধুমাত্র একটি নামযুক্ত স্থানে।
- একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করার জন্য
কলিং ব্যবহারকারী এবং অন্য মানব ব্যবহারকারীর মধ্যে একটি DM তৈরি করতে, আপনার অনুরোধে মানব ব্যবহারকারীর সদস্যতা নির্দিষ্ট করুন।
কলিং ব্যবহারকারী এবং কলিং অ্যাপের মধ্যে একটি DM তৈরি করতে, space.singleUserBotDm
কে true
সেট করুন এবং কোনো সদস্যতা নির্দিষ্ট করবেন না। আপনি শুধুমাত্র কলিং অ্যাপের সাথে একটি DM সেট আপ করতে এই পদ্ধতিটি ব্যবহার করতে পারেন৷ কলিং অ্যাপটিকে একটি স্পেসের সদস্য বা দুটি মানব ব্যবহারকারীর মধ্যে বিদ্যমান DM হিসাবে যোগ করতে, একটি সদস্যতা তৈরি করুন দেখুন।
নিম্নলিখিত উদাহরণটি একটি নামযুক্ত স্থান তৈরি করে এবং দুটি মানব ব্যবহারকারীর (প্রমাণিত ব্যবহারকারী এবং অন্য একজন ব্যবহারকারী) জন্য স্থানটিতে একটি সদস্যতা তৈরি করে।
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
DISPLAY_NAME
: নতুন স্থানের প্রদর্শন নাম। -
USER_NAME
: সদস্যতা অন্তর্ভুক্ত করার জন্য অন্য ব্যবহারকারীর আইডি।
স্পেসে যেতে, স্পেসের ইউআরএল তৈরি করতে স্পেসের রিসোর্স আইডি ব্যবহার করুন। আপনি Google Chat রেসপন্স বডিতে স্পেস name
থেকে রিসোর্স আইডি পেতে পারেন। উদাহরণস্বরূপ, যদি আপনার স্থানের name
হয় spaces/1234567
, তাহলে আপনি নিম্নলিখিত URL ব্যবহার করে স্পেসটিতে যেতে পারেন: https://mail.google.com/chat/u/0/#chat/space/1234567
।
সম্পর্কিত বিষয়
- একটি স্থান তৈরি করুন ।
- একটি স্থান সম্পর্কে বিশদ পান ।
- স্থান তালিকা .
- একটি স্থান আপডেট করুন ।
- একটি স্থান মুছুন ।
- একটি সরাসরি বার্তা স্থান খুঁজুন .
- নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্থান আবিষ্কারযোগ্য করুন ।