এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর membership
সংস্থানে create
পদ্ধতি ব্যবহার করতে হয় যাতে একজন ব্যবহারকারী, Google Group, বা Chat অ্যাপকে আমন্ত্রণ জানানো বা যোগ করা যায় যেটিকে সদস্যতা তৈরি করাও বলা হয়। একটি সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বতঃ-স্বীকার নীতি বন্ধ থাকে, তাহলে তারা আমন্ত্রিত, এবং যোগদানের আগে অবশ্যই স্পেস আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, একটি সদস্যপদ তৈরি করা সদস্যকে সরাসরি নির্দিষ্ট স্থানে যোগ করে।
Membership
রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।
পূর্বশর্ত
পাইথন
- পাইথন 3.6 বা তার বেশি
- পাইপ প্যাকেজ ম্যানেজমেন্ট টুল
পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।
চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। সদস্যপদ তৈরি করতে
chat.memberships
বাchat.memberships.app
অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।
Node.js
- Node.js এবং npm
Node.js-এর জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
npm install @google-cloud/local-auth @googleapis/chat
- Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।
চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। সদস্যপদ তৈরি করতে
chat.memberships
বাchat.memberships.app
অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।
একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানান বা যোগ করুন
একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানাতে বা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.memberships
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
membership
রিসোর্সেcreate
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য
parent
সেট করুন। -
member
users/{user}
সেট করুন যেখানে{user}
হল সেই ব্যক্তি যার জন্য আপনি সদস্যতা তৈরি করতে চান এবং হয়:- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
resourceName
হয়people/123456789
, তাহলেmembership.member.name
সেট করুনusers/123456789
। - ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
- ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ,
users/222larabrown@gmail.com
বাusers/larabrown@cymbalgroup.com
। ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।
- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
নিম্নলিখিত উদাহরণ একটি স্থান একটি ব্যবহারকারী যোগ করে:
পাইথন
- আপনার কাজের ডিরেক্টরিতে,
chat_membership_user_create.py
নামে একটি ফাইল তৈরি করুন। chat_membership_user_create.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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then adds a user to a Chat space by creating a membership. ''' # 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().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
: একটি স্থানের নাম, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।USER
: একটি ব্যবহারকারী আইডি।
আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
python3 chat_membership_user_create.py
Node.js
- আপনার কাজের ডিরেক্টরিতে,
add-user-to-space.js
নামে একটি ফাইল তৈরি করুন। add-user-to-space.js
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the user to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/USER', type: 'HUMAN'}} }); } addUserToSpace().then(console.log);
কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE
: একটি স্থানের নাম, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।USER
: একটি ব্যবহারকারী আইডি।
আপনার কাজের ডিরেক্টরিতে, নমুনা চালান:
node add-user-to-space.js
চ্যাট এপিআই membership
একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।
একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন৷
একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.memberships
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
membership
রিসোর্সেcreate
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য
parent
সেট করুন। -
groupMember
কেgroups/{group}
সেট করুন যেখানে{group}
হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে। উদাহরণস্বরূপ, যদি ক্লাউড আইডেন্টিটি এপিআইgroups/123456789
নামের একটি গ্রুপ ফেরত দেয়, তাহলেmembership.groupMember.name
groups/123456789
এ সেট করুন।
Google Groups একটি গ্রুপ চ্যাট বা সরাসরি বার্তা যোগ করা যাবে না, কিন্তু শুধুমাত্র একটি নামযুক্ত স্থান যোগ করা যাবে. নিম্নলিখিত উদাহরণ একটি নামযুক্ত স্থান একটি গ্রুপ যোগ করে:
পাইথন
- আপনার কাজের ডিরেক্টরিতে,
chat_membership_group_create.py
নামে একটি ফাইল তৈরি করুন। chat_membership_group_create.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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then adds a group to a Chat space by creating a membership. ''' # 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().members().create( # The named space in which to create a membership. parent = 'spaces/SPACE', # Specify which group the membership is for. body = { 'groupMember': { 'name':'groups/GROUP', } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE
: একটি স্থানের নাম, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।GROUP
: একটি গ্রুপ আইডি।
আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
python3 chat_membership_group_create.py
Node.js
- আপনার কাজের ডিরেক্টরিতে,
add-group-to-space.js
নামে একটি ফাইল তৈরি করুন। add-group-to-space.js
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the group to the Chat space. * @return {!Promise<!Object>} */ async function addUserToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {groupMember: {name: 'groups/GROUP'}} }); } addUserToSpace().then(console.log);
কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE
: একটি স্থানের নাম, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।GROUP
: একটি গ্রুপ আইডি।
আপনার কাজের ডিরেক্টরিতে, নমুনা চালান:
node add-group-to-space.js
চ্যাট এপিআই membership
একটি উদাহরণ প্রদান করে যা তৈরি করা গ্রুপ সদস্যতার বিবরণ দেয়।
একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন
একটি চ্যাট অ্যাপ একটি স্পেসে সদস্য হিসাবে অন্য অ্যাপ যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুটি মানব ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.memberships.app
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
membership
রিসোর্সেcreate
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য
parent
সেট করুন। -
users/app
member
সেট করুন; একটি উপনাম যা চ্যাট API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।
নিম্নলিখিত উদাহরণটি একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে:
পাইথন
- আপনার কাজের ডিরেক্টরিতে,
chat_membership_app_create.py
নামে একটি ফাইল তৈরি করুন। chat_membership_app_create.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.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then adds the Chat app to a Chat space. ''' # 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().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Set the Chat app as the entity that gets added to the space. # 'app' is an alias for the Chat app calling the API. body = { 'member': { 'name':'users/app', 'type': 'BOT' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
কোডে, একটি স্পেস নাম দিয়ে
SPACE
প্রতিস্থাপন করুন, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
python3 chat_membership_app_create.py
Node.js
- আপনার কাজের ডিরেক্টরিতে,
add-app-to-space.js
নামে একটি ফাইল তৈরি করুন। add-app-to-space.js
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Adds the app to the Chat space. * @return {!Promise<!Object>} */ async function addAppToSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.memberships.app', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.members.create({ parent: 'spaces/SPACE', requestBody: {member: {name: 'users/app', type: 'BOT'}} }); } addAppToSpace().then(console.log);
কোডে, একটি স্পেস নাম দিয়ে
SPACE
প্রতিস্থাপন করুন, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।আপনার কাজের ডিরেক্টরিতে, নমুনা চালান:
node add-app-to-space.js
চ্যাট API membership
একটি উদাহরণ প্রদান করে যা তৈরি করা অ্যাপ সদস্যতার বিবরণ দেয়।
সম্পর্কিত বিষয়
- ব্যবহারকারী বা চ্যাট অ্যাপের সদস্যতা সম্পর্কে বিশদ বিবরণ পান ।
- একটি স্পেসে সদস্যদের তালিকা করুন ।
- একটি Google চ্যাট স্পেসে একজন ব্যবহারকারীর সদস্যতা আপডেট করুন ।
- একটি স্থান থেকে একটি ব্যবহারকারী বা চ্যাট অ্যাপ সরান ।