এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর Membership রিসোর্সে create() পদ্ধতি ব্যবহার করে কোনও ব্যবহারকারী, Google Group, অথবা Chat অ্যাপকে সদস্যপদ তৈরি করা নামে পরিচিত একটি স্পেসে আমন্ত্রণ জানাতে বা যোগ করতে হয়। সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বয়ংক্রিয়-গ্রহণ নীতি বন্ধ থাকে, তাহলে তাকে আমন্ত্রণ জানানো হবে এবং যোগদানের আগে তাকে অবশ্যই স্পেসের আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, সদস্যপদ তৈরি করলে সদস্যকে সরাসরি নির্দিষ্ট স্পেসে যুক্ত করা হবে।
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার Google Workspace প্রতিষ্ঠানের যেকোনো স্পেসে ব্যবহারকারী, Google Groups, অথবা Chat অ্যাপ যোগ করতে পারবেন।
Membership রিসোর্সটি প্রতিনিধিত্ব করে যে কোনও মানব ব্যবহারকারী বা Google Chat অ্যাপ কোনও স্পেসে আমন্ত্রিত, আংশিক, নাকি অনুপস্থিত।
পূর্বশর্ত
নোড.জেএস
- 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.membershipsঅনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()পদ্ধতিটি কল করুন। - সদস্যপদ তৈরি করার জন্য স্থানের রিসোর্স নাম হিসেবে
parentলিখুন। - সদস্যপদ পাস করার জন্য
membershipনিম্নলিখিত বিষয়গুলি সহ তার ফিল্ডmemberসেট সহMembershipএকটি উদাহরণ হিসাবে ব্যবহার করুন:-
typeফিল্ডটিHUMANএ সেট করা হয়েছে। -
nameক্ষেত্রটিusers/{user}এ সেট করা আছে যেখানে{user}হল সেই ব্যক্তি যাকে আপনি স্পেসে যোগ করতে চান। Chat user নির্দিষ্ট করতে,{user}নিম্নলিখিত যেকোনো একটি দিয়ে প্রতিস্থাপন করুন:- People API-তে থাকা ব্যক্তির আইডি। উদাহরণস্বরূপ, যদি People API person
resourceNamepeople/123456789হয়, তাহলেusers/123456789মানটি ব্যবহার করুন। - ডিরেক্টরি API-তে ব্যবহারকারীর আইডি।
- ব্যবহারকারীর ইমেল ঠিকানা। উদাহরণস্বরূপ,
users/222larabrown@gmail.comঅথবাusers/larabrown@cymbalgroup.com। ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন অথবা অন্য কোনও Google Workspace সংস্থার সাথে যুক্ত হন, তাহলে আপনাকে অবশ্যই তাদের ইমেল ঠিকানা ব্যবহার করতে হবে।
- People API-তে থাকা ব্যক্তির আইডি। উদাহরণস্বরূপ, যদি People API person
-
নিম্নলিখিত উদাহরণটি ব্যবহারকারী প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে যুক্ত করে:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসেরnameথেকে আইডি। আপনিListSpaces()পদ্ধতিতে কল করে অথবা স্পেসের URL থেকে আইডিটি পেতে পারেন। -
USER_NAME: একটি ব্যবহারকারী আইডি।
চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিশদ বিবরণ দেয়।
কোনও স্পেসে Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন
ব্যবহারকারী প্রমাণীকরণ সহ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যোগ করতে ( অ্যাপ প্রমাণীকরণ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যোগ করতে সমর্থন করে না), আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.membershipsঅনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()পদ্ধতিটি কল করুন। - সদস্যপদ তৈরি করার জন্য স্থানের রিসোর্স নাম হিসেবে
parentলিখুন। -
membershipপাস করার জন্যMembershipফিল্ডেরnamegroupMembergroups/{group}এ সেট করুন যেখানে{group}হল সেই গ্রুপ আইডি যার জন্য আপনি সদস্যপদ তৈরি করতে চান। গ্রুপের আইডিটি ক্লাউড আইডেন্টিটি API ব্যবহার করে পুনরুদ্ধার করা যেতে পারে।
গুগল গ্রুপস কোনও গ্রুপ চ্যাট বা ডাইরেক্ট মেসেজে যোগ করা যাবে না, শুধুমাত্র একটি নামযুক্ত স্পেসে যোগ করা যাবে।
নিম্নলিখিত উদাহরণটি ব্যবহারকারী প্রমাণীকরণ সহ একটি নামযুক্ত স্পেসে একটি গ্রুপ যোগ করে:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসেরnameথেকে আইডি। আপনিListSpaces()পদ্ধতিতে কল করে অথবা স্পেসের URL থেকে আইডিটি পেতে পারেন। -
GROUP_NAME: একটি গ্রুপ আইডি।
চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিশদ বিবরণ দেয়।
একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন
একটি চ্যাট অ্যাপ একটি স্পেসে অন্য কোনও অ্যাপকে সদস্য হিসেবে যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুজন মানব ব্যবহারকারীর মধ্যে সরাসরি বার্তা পাঠাতে, ব্যবহারকারী প্রমাণীকরণের মাধ্যমে আপনার অনুরোধে নিম্নলিখিতটি পাস করুন ( অ্যাপ প্রমাণীকরণ একটি স্পেসে একটি চ্যাট অ্যাপ আমন্ত্রণ জানানো বা যোগ করা সমর্থন করে না):
-
chat.memberships.appঅনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()পদ্ধতিটি কল করুন। - সদস্যপদ তৈরি করার জন্য স্থানের রিসোর্স নাম হিসেবে
parentলিখুন। - সদস্যপদ পাস করার জন্য
membershipনিম্নলিখিত বিষয়গুলি সহ তার ফিল্ডmemberসেট সহMembershipএকটি উদাহরণ হিসাবে ব্যবহার করুন:-
typeফিল্ডটিBOTতে সেট করা হয়েছে। -
nameক্ষেত্রটিusers/appএ সেট করা হয়েছে; একটি উপনাম যা Chat API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।
-
নিচের উদাহরণটি একটি স্পেসে একটি Chat অ্যাপ যোগ করে:
নোড.জেএস
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনাটি চালানোর জন্য, SPACE_NAME এর পরিবর্তে স্পেসের name আইডিটি ব্যবহার করুন। আপনি ListSpaces() পদ্ধতিতে কল করে অথবা স্পেসের URL থেকে আইডিটি পেতে পারেন।
চ্যাট এপিআই Membership একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিশদ বিবরণ দেয়।
চ্যাট অ্যাপ ব্যবহার করে কোনও ব্যবহারকারীকে স্পেসে আমন্ত্রণ জানান বা যোগ করুন
অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানাতে বা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.app.membershipsঅনুমোদনের সুযোগ নির্দিষ্ট করুন। -
membershipরিসোর্সেcreateপদ্ধতিটি কল করুন। - যে জায়গায় সদস্যপদ তৈরি করতে হবে, তার রিসোর্সের নাম
parentহিসেবে সেট করুন। -
memberusers/{user}হিসেবে সেট করুন যেখানে{user}হলেন সেই ব্যক্তি যার জন্য আপনি সদস্যপদ তৈরি করতে চান, এবং এর মধ্যে হয়:- People API-তে থাকা ব্যক্তির আইডি। উদাহরণস্বরূপ, যদি People API person
resourceNamepeople/123456789হয়, তাহলেmembership.member.nameকেusers/123456789এ সেট করুন। - ডিরেক্টরি API-তে ব্যবহারকারীর আইডি।
- ব্যবহারকারীর ইমেল ঠিকানা। উদাহরণস্বরূপ,
users/222larabrown@gmail.comঅথবাusers/larabrown@cymbalgroup.com। ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন অথবা অন্য কোনও Google Workspace সংস্থার সাথে যুক্ত হন, তাহলে আপনাকে অবশ্যই তাদের ইমেল ঠিকানা ব্যবহার করতে হবে।
- People API-তে থাকা ব্যক্তির আইডি। উদাহরণস্বরূপ, যদি People API person
চ্যাট এপিআই কল করে এমন একটি স্ক্রিপ্ট লিখুন
নিম্নলিখিত উদাহরণটি অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে যুক্ত করে:
পাইথন
- আপনার ওয়ার্কিং ডিরেক্টরিতে,
chat_membership_app_create.pyনামে একটি ফাইল তৈরি করুন। chat_membership_app_create.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.memberships"] def main(): ''' Authenticates with Chat API using app authentication, then adds a user to a Chat space by creating a membership. ''' # 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().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Specify which user the membership is for. body = { 'member': { 'name':'users/USER', 'type': 'HUMAN' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE: একটি স্পেস নাম, যা আপনি চ্যাট API-এরspaces.listপদ্ধতি থেকে অথবা একটি স্পেসের URL থেকে পেতে পারেন।USER: একটি ব্যবহারকারী আইডি।
আপনার কার্যকরী ডিরেক্টরিতে, নমুনাটি তৈরি করুন এবং চালান:
python3 chat_membership_app_create.py
Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে স্পেসে ব্যবহারকারী বা Google Groups যোগ করুন
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার Google Workspace প্রতিষ্ঠানের যেকোনো স্পেসে ব্যবহারকারী, Google Groups, অথবা Chat অ্যাপ যোগ করার জন্য create() পদ্ধতি ব্যবহার করতে পারেন।
এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে কল করতে, নিম্নলিখিতগুলি করুন:
- ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে পদ্ধতিটি কল করুন, এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের অধিকার ব্যবহার করে পদ্ধতিটি কল করা সমর্থন করে।
- আপনার অনুরোধে,
useAdminAccessথেকেtrueকোয়েরি প্যারামিটারটি উল্লেখ করুন।
আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।
সীমাবদ্ধতা এবং বিবেচনা
- অ্যাপ প্রমাণীকরণের মাধ্যমে, একটি চ্যাট অ্যাপ ব্যবহারকারীদের আমন্ত্রণ জানাতে বা যোগ করতে পারে, কিন্তু Google Groups বা Chat অ্যাপগুলিকে নয়। নিজেকে যোগ করার জন্য, একটি চ্যাট অ্যাপকে
chat.membershipsঅনুমোদনের সুযোগের সাথে ব্যবহারকারী প্রমাণীকরণ ব্যবহার করতে হবে।
সম্পর্কিত বিষয়
- একজন ব্যবহারকারীর বা চ্যাট অ্যাপের সদস্যপদ সম্পর্কে বিস্তারিত জানুন ।
- একটি স্পেসে সদস্যদের তালিকা তৈরি করুন ।
- গুগল চ্যাট স্পেসে একজন ব্যবহারকারীর সদস্যপদ আপডেট করুন ।
- কোনও স্পেস থেকে কোনও ব্যবহারকারী বা চ্যাট অ্যাপ সরান ।