এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে একটি Google চ্যাট স্পেস সেট আপ করতে Google Chat API-এর Space
রিসোর্সে setup
পদ্ধতি ব্যবহার করতে হয়। একটি স্থান সেট আপ করা একটি স্থান তৈরি করে এবং এটিতে নির্দিষ্ট ব্যবহারকারীদের যোগ করে।
Space
রিসোর্স এমন একটি জায়গাকে প্রতিনিধিত্ব করে যেখানে লোকেরা এবং চ্যাট অ্যাপ মেসেজ পাঠাতে, ফাইল শেয়ার করতে এবং সহযোগিতা করতে পারে। বিভিন্ন ধরনের স্পেস আছে:
- ডাইরেক্ট মেসেজ (DMs) হল দুই ব্যবহারকারী বা একজন ব্যবহারকারী এবং একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
- গ্রুপ চ্যাট হল তিন বা ততোধিক ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে কথোপকথন।
- নামযুক্ত স্থানগুলি স্থায়ী স্থান যেখানে লোকেরা বার্তা পাঠায়, ফাইলগুলি ভাগ করে এবং সহযোগিতা করে৷
একটি স্থান সেট আপ করার সময়, নিম্নলিখিত বিবেচনা করুন:
- কলিং (প্রমাণিত) ব্যবহারকারী স্বয়ংক্রিয়ভাবে স্পেসে যুক্ত হয়, তাই আপনাকে অনুরোধে ব্যবহারকারীর সদস্যতা নির্দিষ্ট করতে হবে না।
- একটি সরাসরি বার্তা (DM) তৈরি করার সময়, যদি দুটি ব্যবহারকারীর মধ্যে একটি DM বিদ্যমান থাকে, তাহলে DM ফেরত দেওয়া হয়। অন্যথায়, একটি DM তৈরি করা হয়।
- একটি গ্রুপ চ্যাট তৈরি করার সময়, যদি অনুরোধে প্রদত্ত সদস্যতাগুলির একটিও সফলভাবে গ্রুপ চ্যাটে যোগ করা না হয় (উদাহরণস্বরূপ, অনুমতির সমস্যা), তাহলে একটি খালি গ্রুপ চ্যাট (শুধুমাত্র কলিং ব্যবহারকারী সহ) তৈরি হতে পারে।
- আপনি থ্রেড করা উত্তর দিয়ে স্পেস সেট-আপ করতে পারবেন না বা আপনার Google Workspace-এর বাইরের লোকদের যোগ করতে পারবেন না।
- অনুরোধে প্রদত্ত ডুপ্লিকেট সদস্যতা (কলিং ব্যবহারকারী সহ) অনুরোধ ত্রুটির পরিবর্তে ফিল্টার আউট করা হয়।
পূর্বশর্ত
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- পাইথন গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js Google API ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন । এই নির্দেশিকায় নমুনাটি চালানোর জন্য, আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷
- ব্যবহারকারীর প্রমাণীকরণ সমর্থন করে এমন একটি অনুমোদনের সুযোগ বেছে নিন ।
একটি স্থান সেট আপ করুন
একটি স্থান সেট আপ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.spaces.create
বাchat.spaces
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
Space
রিসোর্সেsetup
পদ্ধতিতে কল করুন। - একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করতে,
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 হিসাবে যোগ করতে, একটি সদস্যতা তৈরি করুন দেখুন।
নিম্নলিখিত উদাহরণটি একটি নামযুক্ত স্থান তৈরি করে এবং একটি গোষ্ঠী এবং তিনজন মানব ব্যবহারকারীর (প্রমাণিত ব্যবহারকারী এবং অন্য দুটি নির্দিষ্ট ব্যবহারকারী সহ) জন্য স্থানের সদস্যতা তৈরি করে।
পাইথন
- আপনার কাজের ডিরেক্টরিতে,
chat_space_setup.py
নামে একটি ফাইল তৈরি করুন। chat_space_setup.py
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then sets up a Chat space by creating a space and adding members. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().setup( # Details about the space to set up. body = { # Attributes of the space to set up, like space type and display name. 'space': { # To set up a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space 'displayName': 'API-setup' }, # The users and groups to add to the space. # # The authenticated user is automatically added to the space, # and doesn't need to be specified in the memberships array. 'memberships': [ { 'member': { 'name':'users/123456789', 'type': 'HUMAN' } }, { 'member': { 'name':'users/987654321', 'type': 'HUMAN' } }, { 'groupMember': { 'name': 'groups/11223344' } } ] } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
python3 chat_space_setup.py
Node.js
- আপনার কাজের ডিরেক্টরিতে,
setup-space.js
নামে একটি ফাইল তৈরি করুন। setup-space.js
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Sets up a new Chat space with users. * @return {!Promise<!Object>} */ async function setupSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.setup({ requestBody: { space: { spaceType: 'SPACE', displayName: 'API-made', }, memberships: [ {member: {name: 'users/123456789', type: 'HUMAN'}}, {member: {name: 'users/987654321', type: 'HUMAN'}}, {groupMember: {name: 'groups/11223344'}}, ] } }); } setupSpace().then(console.log);
আপনার কাজের ডিরেক্টরিতে, নমুনা চালান:
node setup-space.js
প্রমাণীকৃত ব্যবহারকারী সহ একটি গ্রুপ এবং তিনজন মানব ব্যবহারকারীর সাথে একটি নামযুক্ত চ্যাট স্পেস সেট আপ করা হয়েছে।
স্পেসে যেতে, স্পেসের ইউআরএল তৈরি করতে স্পেসের রিসোর্স আইডি ব্যবহার করুন। আপনি Google Chat রেসপন্স বডিতে স্পেস name
থেকে রিসোর্স আইডি পেতে পারেন। উদাহরণস্বরূপ, যদি আপনার স্থানের name
হয় spaces/1234567
, তাহলে আপনি নিম্নলিখিত URL ব্যবহার করে স্পেসটিতে যেতে পারেন: https://mail.google.com/chat/u/0/#chat/space/1234567
।
সম্পর্কিত বিষয়
- একটি স্থান তৈরি করুন ।
- একটি স্থান সম্পর্কে বিশদ পান ।
- স্থান তালিকা .
- একটি স্থান আপডেট করুন ।
- একটি স্থান মুছুন ।
- একটি সরাসরি বার্তা স্থান খুঁজুন .
- নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্থান আবিষ্কারযোগ্য করুন ।