এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর Space রিসোর্সে create() পদ্ধতি ব্যবহার করে একটি নামযুক্ত স্পেস তৈরি করতে হয়।
একটি নামযুক্ত স্পেস (যেখানে spaceType হল SPACE ) হল এমন একটি জায়গা যেখানে লোকেরা বার্তা পাঠায়, ফাইল শেয়ার করে এবং সহযোগিতা করে। নামযুক্ত স্পেসগুলিতে চ্যাট অ্যাপ অন্তর্ভুক্ত থাকতে পারে। নামযুক্ত স্পেসগুলিতে স্পেস ম্যানেজার থাকে যারা প্রশাসনিক সেটিংস, বিবরণ প্রয়োগ করতে এবং মানুষ এবং অ্যাপ যোগ করতে বা সরাতে পারে।
বিভিন্ন ধরণের চ্যাট স্পেস তৈরি করতে (সরাসরি বার্তা বা গ্রুপ বার্তা সহ), Space রিসোর্সে setUp() পদ্ধতি ব্যবহার করে স্পেস তৈরি করুন এবং একই সাথে সদস্যদের যোগ করুন। বিস্তারিত জানার জন্য, একটি স্পেস সেট আপ করুন ।
একটি নামযুক্ত স্পেস তৈরি করার পর, স্পেসের একমাত্র সদস্য হলেন প্রমাণিত ব্যবহারকারী। স্পেসে সদস্য যোগ করতে, আপনি যে ব্যক্তি বা অ্যাপ যোগ করতে চান তার জন্য Membership রিসোর্সে create() পদ্ধতিটি কল করুন। অথবা, আপনি setUp() পদ্ধতি ব্যবহার করে একটি নামযুক্ত স্পেস তৈরি করতে পারেন এবং একই সাথে এতে সদস্য যোগ করতে পারেন।
পূর্বশর্ত
নোড.জেএস
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য নাম, আইকন এবং বিবরণ সহ Google Chat API সক্ষম এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার Google Chat API অনুরোধে আপনি কীভাবে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেস শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে আপনার স্থানীয় ডিরেক্টরিতে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
- আপনি ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান নাকি চ্যাট অ্যাপ হিসেবে, তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য নাম, আইকন এবং বিবরণ সহ Google Chat API সক্ষম এবং কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার Google Chat API অনুরোধে আপনি কীভাবে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেস শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে আপনার স্থানীয় ডিরেক্টরিতে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
- আপনি ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান নাকি চ্যাট অ্যাপ হিসেবে, তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
জাভা
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য নাম, আইকন এবং বিবরণ সহ Google Chat API সক্ষম এবং কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার Google Chat API অনুরোধে আপনি কীভাবে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেস শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে আপনার স্থানীয় ডিরেক্টরিতে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
- আপনি ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান নাকি চ্যাট অ্যাপ হিসেবে, তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য নাম, আইকন এবং বিবরণ সহ Google Chat API সক্ষম এবং কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং অ্যাডভান্সড চ্যাট পরিষেবা চালু করুন।
- এই নির্দেশিকায়, আপনাকে ব্যবহারকারী অথবা অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্ট শংসাপত্র তৈরি করুন। ধাপগুলির জন্য, Google চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ এবং অনুমোদন দেখুন।
- আপনি ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান নাকি চ্যাট অ্যাপ হিসেবে, তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
ব্যবহারকারী হিসেবে একটি নামযুক্ত স্থান তৈরি করুন
ব্যবহারকারী প্রমাণীকরণের মাধ্যমে একটি নামযুক্ত স্থান তৈরি করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.spaces.createঅথবাchat.spacesঅনুমোদনের সুযোগ নির্দিষ্ট করুন। - নিম্নলিখিত ক্ষেত্রগুলি ব্যবহার করে
Spaceএর একটি উদাহরণ হিসেবেspaceপাস করেCreateSpace()পদ্ধতিটি কল করুন:-
spaceTypeSPACEতে সেট করা হয়েছে। -
displayNameস্পেসের ব্যবহারকারী-দৃশ্যমান নামে সেট করা হয়েছে। - ঐচ্ছিকভাবে, অন্যান্য বৈশিষ্ট্য সেট করুন, যেমন নিম্নলিখিত:
-
spaceDetails- স্থানের জন্য ব্যবহারকারীর দৃষ্টিগোচর একটি বিবরণ এবং নির্দেশিকাগুলির একটি সেট। -
predefinedPermissionSettings- স্থানের জন্য পূর্বনির্ধারিত অনুমতি। উদাহরণস্বরূপ, আপনি এটি এমনভাবে কনফিগার করতে পারেন যাতে সমস্ত সদস্য অথবা শুধুমাত্র স্থান পরিচালকরা বার্তা পোস্ট করতে পারেন।
-
-
একটি নামযুক্ত স্থান কীভাবে তৈরি করবেন তা এখানে দেওয়া হল:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
চ্যাট অ্যাপ হিসেবে একটি নামযুক্ত স্পেস তৈরি করুন
অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানাতে বা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.app.spaces.createঅথবাchat.app.spacesঅনুমোদনের সুযোগ নির্দিষ্ট করুন। -
Spaceরিসোর্সেcreateমেথডটি কল করুন। -
spaceTypeSPACEতে সেট করুন। -
displayNameকে স্পেসের ব্যবহারকারী-দৃশ্যমান নামে সেট করুন। নিম্নলিখিত উদাহরণে,displayNameAPI-madeতে সেট করা আছে। -
customerক্ষেত্র ব্যবহার করে Google Workspace ডোমেনের গ্রাহক আইডি উল্লেখ করুন। - ঐচ্ছিকভাবে, অন্যান্য স্পেস অ্যাট্রিবিউট সেট করুন, যেমন
spaceDetails(একটি ব্যবহারকারী-দৃশ্যমান বিবরণ এবং স্পেসের জন্য নির্দেশিকাগুলির সেট)।
চ্যাট এপিআই কল করে এমন একটি স্ক্রিপ্ট লিখুন
একটি নামযুক্ত স্থান কীভাবে তৈরি করবেন তা এখানে দেওয়া হল:
পাইথন
- আপনার কার্যকরী ডিরেক্টরিতে,
chat_space_create_named_app.pyনামে একটি ফাইল তৈরি করুন। chat_space_create_named_app.pyতে নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:from google.oauth2 import service_account from apiclient.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.app.spaces.create"] def main(): ''' Authenticates with Chat API using app authentication, then creates a Chat space. ''' # Specify service account details. creds = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made', # The customer ID of the Workspace domain. 'customer': 'CUSTOMER' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
CUSTOMER:customer/{customer}ফর্ম্যাটে স্পেসের ডোমেনের গ্রাহক আইডি যেখানে{customer}হল Admin SDK গ্রাহক রিসোর্স থেকেID। Chat অ্যাপের মতো একই Google Workspace সংস্থায় একটি স্থান তৈরি করতে,customers/my_customerব্যবহার করুন।
-
আপনার কার্যকরী ডিরেক্টরিতে, নমুনাটি তৈরি করুন এবং চালান:
python3 chat_space_create_named_app.py
Google Chat-এ স্পেস খুলুন
স্পেসে নেভিগেট করতে, স্পেসের URL তৈরি করতে স্পেসের রিসোর্স আইডি ব্যবহার করুন। আপনি গুগল চ্যাট রেসপন্স বডিতে স্পেসের name থেকে রিসোর্স আইডি খুঁজে পেতে পারেন। উদাহরণস্বরূপ, যদি আপনার স্পেসের name spaces/1234567 হয়, তাহলে আপনি নিম্নলিখিত URL ব্যবহার করে স্পেসে নেভিগেট করতে পারেন: https://mail.google.com/chat/u/0/#chat/space/1234567 ।
সীমাবদ্ধতা এবং বিবেচনা
- যখন আপনি অ্যাপ প্রমাণীকরণ ব্যবহার করে একটি স্পেস তৈরি করেন, তখন প্রমাণীকরণকারী চ্যাট অ্যাপটি স্পেসের সদস্য হিসেবে যোগ করা হয়, তবে ব্যবহারকারী প্রমাণীকরণের বিপরীতে, স্পেস ম্যানেজার হিসেবে নয়। ডিফল্টরূপে, সমস্ত স্পেস সদস্য চ্যাট অ্যাপটি সরাতে পারেন। শুধুমাত্র স্পেস ম্যানেজারদের চ্যাট অ্যাপটি সরানোর অনুমতি দিতে,
permissionSettings.manageAppsকেmanagersAllowedএ সেট করুন।
সম্পর্কিত বিষয়
- সদস্য তৈরি করে স্পেসে মানুষ এবং অ্যাপ যোগ করুন।
- একটি বার্তা তৈরি করে স্পেসে একটি বার্তা পোস্ট করুন।
- একটি স্থান সম্পর্কে বিস্তারিত জানুন ।
- স্পেস তালিকাভুক্ত করুন ।
- একটি স্থান আপডেট করুন ।
- একটি স্থান মুছুন ।
- একটি স্থান তৈরি করুন ।
- সরাসরি বার্তার জন্য একটি স্থান খুঁজুন ।
- নির্দিষ্ট ব্যবহারকারীদের জন্য একটি স্থান আবিষ্কারযোগ্য করে তুলুন ।