একটি স্থান থেকে একটি সদস্য সরান

এই গাইডটি ব্যাখ্যা করে যে Google Chat API-এর Membership রিসোর্সে delete() মেথড ব্যবহার করে স্পেস থেকে মেম্বারদের সরিয়ে দিতে হয়, যা মেম্বারশিপ মুছে ফেলা নামেও পরিচিত। স্পেস ম্যানেজারদের সরানো যাবে না যদি তারা একটি স্পেসের একমাত্র স্পেস ম্যানেজার হন। এই সদস্যপদগুলি সরানোর আগে অন্য ব্যবহারকারীকে স্পেস ম্যানেজার হিসাবে বরাদ্দ করুন৷

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেস থেকে ব্যবহারকারী, Google Groups বা Chat অ্যাপ সরিয়ে দিতে পারেন।

Membership রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

ব্যবহারকারী হিসাবে একটি স্থান থেকে একজন সদস্যকে সরান৷

ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেস থেকে ব্যবহারকারী, Google গ্রুপ বা চ্যাট অ্যাপ সরাতে, আপনার অনুরোধে নিম্নলিখিতগুলি পাস করুন:

  • chat.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন। অনুমোদনকারী ব্যবহারকারীর অবশ্যই স্পেস থেকে ব্যবহারকারী বা Google গ্রুপকে সরানোর অনুমতি থাকতে হবে। একটি চ্যাট অ্যাপ সরাতে, chat.memberships.app অনুমোদনের সুযোগ নির্দিষ্ট করুন (অ্যাপগুলি শুধুমাত্র তাদের নিজস্ব সদস্যতা মুছে ফেলতে পারে; অন্য অ্যাপের নয়)। একটি সর্বোত্তম অনুশীলন হিসাবে, সর্বাধিক সীমাবদ্ধ সুযোগ বেছে নিন যা এখনও আপনার অ্যাপটিকে কাজ করার অনুমতি দেয়।
  • DeleteMembership() পদ্ধতিতে কল করুন।
  • সদস্যপদ মুছে ফেলার name পাস. যদি সদস্যপদটি একটি স্পেসের একমাত্র স্পেস ম্যানেজারের অন্তর্গত হয়, তাহলে এই সদস্যপদটি মুছে ফেলার আগে অন্য ব্যবহারকারীকে স্পেস ম্যানেজার হিসাবে বরাদ্দ করুন৷

ব্যবহারকারীর প্রমাণীকরণের সাথে একটি সদস্যপদ মুছে ফেলার উপায় এখানে:

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME'
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

এই নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • MEMBER_NAME : সদস্যের name থেকে আইডি। আপনি ListMemberships() পদ্ধতিতে কল করে আইডি পেতে পারেন।

সফল হলে, প্রতিক্রিয়া সংস্থা 'state': 'NOT_A_MEMBER' , ইঙ্গিত করে যে সদস্যটি আর স্থানটিতে নেই৷

{
    "name": "spaces/SPACE_NAME/members/MEMBER_NAME",
    "state": "NOT_A_MEMBER"
}

একটি স্পেস থেকে একজন সদস্যকে চ্যাট অ্যাপ হিসেবে সরিয়ে দিন

অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

অ্যাপ প্রমাণীকরণ সহ একটি স্পেস থেকে ব্যবহারকারী, Google গ্রুপ বা চ্যাট অ্যাপ সরাতে, আপনার অনুরোধে নিম্নলিখিতগুলি পাস করুন:

  • chat.app.memberships অনুমোদনের সুযোগ নির্দিষ্ট করুন। স্পেস ম্যানেজারের সদস্যতা মুছে ফেলা শুধুমাত্র চ্যাট অ্যাপ দ্বারা তৈরি স্পেসগুলিতে সমর্থিত।
  • membership রিসোর্সে delete মেথড কল করুন।
  • সদস্যপদ মুছে ফেলার name পাস. যদি সদস্যপদটি একটি স্পেসের একমাত্র স্পেস ম্যানেজারের অন্তর্গত হয়, তাহলে এই সদস্যপদটি মুছে ফেলার আগে অন্য ব্যবহারকারীকে স্পেস ম্যানেজার হিসাবে বরাদ্দ করুন৷

একটি API কী তৈরি করুন

একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।

API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
  3. আপনার নতুন API কী প্রদর্শিত হয়৷
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।

একটি স্ক্রিপ্ট লিখুন যা Chat API কল করে

অ্যাপ প্রমাণীকরণের মাধ্যমে কীভাবে সদস্যপদ মুছবেন তা এখানে:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_membership_delete_app.py নামে একটি ফাইল তৈরি করুন।
  2. chat_membership_delete_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 deletes the specified 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, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')
    
        # Use the service endpoint to call Chat API.
        result = chat.spaces().members().delete(
    
            # The membership to delete.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            #
            # Replace MEMBER with a membership name.
            # Obtain the membership name from the memberships resource of
            # Chat API. To delete a Chat app's membership, replace MEMBER
            # with app; an alias for the app calling the API.
            name='spaces/SPACE/members/MEMBER'
    
        ).execute()
    
        # Print Chat API's response in your command line interface.
        # When deleting a membership, the response body is empty.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • API_KEY : চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।

    • MEMBER : একটি সদস্যপদ নাম, যা আপনি Chat API-এর spaces.members.list পদ্ধতি থেকে পেতে পারেন। একটি অ্যাপের সদস্যতা মুছে ফেলতে, app দিয়ে MEMBER প্রতিস্থাপন করুন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_membership_delete_app.py

সফল হলে, প্রতিক্রিয়া সংস্থা 'state': 'NOT_A_MEMBER' , ইঙ্গিত করে যে সদস্যটি আর স্থানটিতে নেই৷

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}

সীমাবদ্ধতা এবং বিবেচনা

  • অ্যাপ প্রমাণীকরণের মাধ্যমে, একটি চ্যাট অ্যাপ ব্যবহারকারীদের সরিয়ে দিতে পারে, কিন্তু Google গ্রুপগুলিকে নয়।

Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে স্পেস থেকে ব্যবহারকারী বা Google Groups সরিয়ে দিন

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনও স্পেস থেকে ব্যবহারকারী, Google Groups বা Chat অ্যাপগুলিকে সরিয়ে দিতে DeleteMembership() পদ্ধতিতে কল করতে পারেন।

এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
  • আপনার অনুরোধে, true ক্যোয়ারী প্যারামিটার useAdminAccess নির্দিষ্ট করুন।

আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।