এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর Membership রিসোর্সে update() পদ্ধতি ব্যবহার করে সদস্যপদ সম্পর্কিত বৈশিষ্ট্যগুলি পরিবর্তন করতে হয়, যেমন একজন স্পেস সদস্যকে স্পেস ম্যানেজার বা স্পেসের মালিকে পরিবর্তন করা।
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার Google Workspace প্রতিষ্ঠানের যেকোনো স্পেসের সদস্যপদ আপডেট করতে update() পদ্ধতি ব্যবহার করতে পারেন।
Membership রিসোর্সটি প্রতিনিধিত্ব করে যে কোনও মানব ব্যবহারকারী বা Google Chat অ্যাপ কোনও স্পেসে আমন্ত্রিত, আংশিক, নাকি অনুপস্থিত।
পূর্বশর্ত
নোড.জেএস
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি গুগল ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য নাম, আইকন এবং বিবরণ সহ Google Chat API সক্ষম এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনার Google Chat API অনুরোধে আপনি কীভাবে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেস শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে আপনার স্থানীয় ডিরেক্টরিতে সংরক্ষণ করুন। - চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.jsonনামে একটি JSON ফাইল হিসেবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
- আপনি ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান নাকি চ্যাট অ্যাপ হিসেবে, তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
সদস্যপদ আপডেট করুন
স্পেসের সদস্যপদ আপডেট করতে, আপনার অনুরোধে নিম্নলিখিতগুলি পাস করুন:
- একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন:
- ব্যবহারকারী প্রমাণীকরণের সাথে,
chat.membershipsঅনুমোদনের সুযোগ নির্দিষ্ট করুন। - অ্যাপ প্রমাণীকরণের ক্ষেত্রে,
chat.app.membershipsঅনুমোদনের সুযোগ নির্দিষ্ট করুন। অ্যাপ প্রমাণীকরণের মাধ্যমে সদস্যপদ আপডেট করার সময়, আপনি কেবল চ্যাট অ্যাপ দ্বারা তৈরি স্পেসে সদস্যপদ আপডেট করতে পারবেন। অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
- ব্যবহারকারী প্রমাণীকরণের সাথে,
-
UpdateMembership()পদ্ধতিটি কল করুন। - নিম্নলিখিত বিষয়গুলি সহ
Membershipপাস করার জন্যmembershipউদাহরণ:-
nameক্ষেত্রটি "সদস্যপদ আপডেট করার জন্য" হিসেবে সেট করা হয়েছে, যার মধ্যে একটি স্পেস আইডি এবং একটি সদস্য আইডি অন্তর্ভুক্ত রয়েছে। - আপডেট করার জন্য সদস্যপদ ক্ষেত্রগুলি নতুন মানের সাথে সেট করা আছে।
-
-
updateMaskপাস করুন যাতে সদস্যপদ আপডেট করার দিকগুলি নির্দিষ্ট করা যায়, এতে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:-
role: চ্যাট স্পেসের মধ্যে ব্যবহারকারীর ভূমিকা, যা স্পেসে তাদের অনুমোদিত ক্রিয়াকলাপ নির্ধারণ করে। বিস্তারিত অনুমতি ব্যাখ্যার জন্য, চ্যাট API রেফারেন্স ডকুমেন্টেশনেMembershipRoleদেখুন। সম্ভাব্য মানগুলি হল:-
ROLE_MEMBER: স্পেসের একজন সদস্য। চ্যাট UI-তে, এই ভূমিকাটিকে সদস্য বলা হয়। -
ROLE_ASSISTANT_MANAGER: একজন স্পেস ম্যানেজার। চ্যাট UI-তে, এই ভূমিকাটিকে ম্যানেজার বলা হয়। -
ROLE_MANAGER: একজন স্পেস মালিক। চ্যাট UI তে, এই ভূমিকাটিকে মালিক বলা হয়।
-
-
একজন সদস্যকে মালিকে পরিবর্তন করুন (ব্যবহারকারী প্রমাণীকরণ)
নিম্নলিখিত উদাহরণে ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে চ্যাট API কে কল করা হয়েছে যাতে ROLE_MANAGER হিসাবে role নির্দিষ্ট করে একজন নিয়মিত স্পেস সদস্যকে স্পেসের মালিক করা যায়:
নোড.জেএস
নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসেরnameথেকে আইডি। আপনিListSpaces()পদ্ধতিতে কল করে অথবা স্পেসের URL থেকে আইডিটি পেতে পারেন। -
MEMBER_NAME: সদস্যেরnameথেকে প্রাপ্ত আইডি। আপনিListMemberships()পদ্ধতিতে কল করে অথবা Chat API-এর সাথে অ্যাসিঙ্ক্রোনাসভাবে সদস্যপদ তৈরি করার পরে ফিরে আসা প্রতিক্রিয়া বডি থেকে আইডিটি পেতে পারেন। -
ROLE_NAME: আপডেট করা ভূমিকা,ROLE_MANAGER। আপনি এই মানটিMembershipRoleএর যেকোনো মানে সেট করতে পারেন। উদাহরণস্বরূপ, নিয়মিত সদস্যকে স্পেস ম্যানেজার করতে,ROLE_NAMEকেROLE_ASSISTANT_MANAGERএ পরিবর্তন করুন।
Google Chat API স্পেসের মালিকের কাছে নির্দিষ্ট সদস্যপদ আপডেট করে এবং Membership এর একটি উদাহরণ ফেরত দেয়।
মালিককে সদস্যে পরিবর্তন করুন (ব্যবহারকারী প্রমাণীকরণ)
নিচের উদাহরণে ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে চ্যাট API কল করা হয়েছে যাতে ROLE_MEMBER এর role উল্লেখ করে একজন স্পেস মালিককে নিয়মিত স্পেস সদস্য করা যায়:
নোড.জেএস
নমুনাটি চালানোর জন্য, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
-
SPACE_NAME: স্পেসেরnameথেকে আইডি। আপনিListSpaces()পদ্ধতিতে কল করে অথবা স্পেসের URL থেকে আইডিটি পেতে পারেন। -
MEMBER_NAME: সদস্যেরnameথেকে প্রাপ্ত আইডি। আপনিListMemberships()পদ্ধতিতে কল করে অথবা Chat API-এর সাথে অ্যাসিঙ্ক্রোনাসভাবে সদস্যপদ তৈরি করার পরে ফিরে আসা প্রতিক্রিয়া বডি থেকে আইডিটি পেতে পারেন। -
ROLE_NAME: আপডেট করা ভূমিকা,ROLE_MEMBER।
Google Chat API স্পেসের মালিকের কাছে নির্দিষ্ট সদস্যপদ আপডেট করে এবং Membership এর একটি উদাহরণ ফেরত দেয়।
একজন সদস্যকে মালিকে পরিবর্তন করুন (চ্যাট অ্যাপ প্রমাণীকরণ)
অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
চ্যাট এপিআই কল করে এমন একটি স্ক্রিপ্ট লিখুন
নিচের উদাহরণে অ্যাপ প্রমাণীকরণ ব্যবহার করে চ্যাট API কে কল করা হয়েছে যাতে নিয়মিত স্পেস সদস্যকে স্পেসের মালিক করা যায়, যেখানে আপডেট করা সদস্যতার বৈশিষ্ট্যগুলি নির্দিষ্ট করে এমন body ROLE_MANAGER হিসেবে role উল্লেখ করা হয়:
পাইথন
- আপনার কার্যকরী ডিরেক্টরিতে,
chat_membership_update_to_owner_app.pyনামে একটি ফাইল তৈরি করুন। chat_membership_update_to_owner_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.memberships"] def main(): ''' Authenticates with Chat API using app authentication, then updates a specified space member to change it from a regular member to a space owner. ''' # 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().patch( # The membership to update, and the updated role. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBERSHIP with a membership name. # Obtain the membership name from the membership of Chat API. name='spaces/SPACE/members/MEMBERSHIP', updateMask='role', # Replace ROLE with a MembershipRole value. # Obtain the MembershipRole values from the membership of Chat API. body={'role': 'ROLE'} ).execute() # Prints details about the updated membership. print(result) if __name__ == '__main__': main()কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE: একটি স্পেস নাম, যা আপনি চ্যাট API-এরspaces.listপদ্ধতি থেকে অথবা একটি স্পেসের URL থেকে পেতে পারেন।MEMBERSHIP: একটি সদস্যপদ নাম, যা আপনি চ্যাট API-এরspaces.members.listপদ্ধতি থেকে পেতে পারেন।ROLE: আপডেট করা ভূমিকা,ROLE_MANAGER। আপনি এই মানটিMembershipRoleএর যেকোনো মানের উপর সেট করতে পারেন। উদাহরণস্বরূপ, নিয়মিত সদস্যকে স্পেস ম্যানেজার করতে,ROLEROLE_ASSISTANT_MANAGERএ পরিবর্তন করুন।
আপনার কার্যকরী ডিরেক্টরিতে, নমুনাটি তৈরি করুন এবং চালান:
python3 chat_membership_update_to_owner_app.py
একজন মালিককে সদস্যে পরিবর্তন করুন (চ্যাট অ্যাপ প্রমাণীকরণ)
অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
চ্যাট এপিআই কল করে এমন একটি স্ক্রিপ্ট লিখুন
নিচের উদাহরণে অ্যাপ প্রমাণীকরণ ব্যবহার করে চ্যাট API কল করা হয়েছে, যাতে স্পেস মালিককে নিয়মিত স্পেস সদস্য করা যায়, যেখানে আপডেট করা সদস্যপদ বৈশিষ্ট্যগুলি নির্দিষ্ট করে এমন body ROLE_MEMBER হিসেবে role উল্লেখ করা হয়:
পাইথন
- আপনার ওয়ার্কিং ডিরেক্টরিতে,
chat_membership_update_to_member_app.pyনামে একটি ফাইল তৈরি করুন। chat_membership_update_to_member_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.memberships"] def main(): ''' Authenticates with Chat API via user credentials, then updates a specified space owner to change it to a regular member. ''' # 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().patch( # The membership to update, and the updated role. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBERSHIP with a membership name. # Obtain the membership name from the membership of Chat API. name='spaces/SPACE/members/MEMBERSHIP', updateMask='role', body={'role': 'ROLE_MEMBER'} ).execute() # Prints details about the updated membership. print(result) if __name__ == '__main__': main()কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SPACE: একটি স্পেস নাম, যা আপনি চ্যাট API-এরspaces.listপদ্ধতি থেকে অথবা একটি স্পেসের URL থেকে পেতে পারেন।MEMBERSHIP: একটি সদস্যপদ নাম, যা আপনি চ্যাট API-এরspaces.members.listপদ্ধতি থেকে পেতে পারেন।
আপনার কার্যকরী ডিরেক্টরিতে, নমুনাটি তৈরি করুন এবং চালান:
python3 chat_membership_update_to_member_app.py
Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে সদস্যপদ আপডেট করুন
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার Google Workspace প্রতিষ্ঠানের যেকোনো স্পেসের সদস্যপদ আপডেট করতে update() পদ্ধতি ব্যবহার করতে পারেন।
এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে কল করতে, নিম্নলিখিতগুলি করুন:
- ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে পদ্ধতিটি কল করুন, এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের অধিকার ব্যবহার করে পদ্ধতিটি কল করা সমর্থন করে।
- আপনার অনুরোধে,
useAdminAccessথেকেtrueকোয়েরি প্যারামিটারটি উল্লেখ করুন।
আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।
সম্পর্কিত বিষয়
- কোনও ব্যবহারকারী বা Google Chat অ্যাপকে স্পেসে আমন্ত্রণ জানান বা যোগ করুন ।
- একজন ব্যবহারকারীর বা চ্যাট অ্যাপের সদস্যপদ সম্পর্কে বিস্তারিত জানুন ।
- একটি স্পেসে সদস্যদের তালিকা তৈরি করুন ।
- কোনও স্পেস থেকে কোনও ব্যবহারকারী বা চ্যাট অ্যাপ সরান ।