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

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

আপনি যদি একজন গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের যেকোনো স্পেস থেকে ব্যবহারকারী, গুগল গ্রুপ বা চ্যাট অ্যাপ মুছে ফেলতে পারবেন।

Membership রিসোর্সটি নির্দেশ করে যে কোনো মানব ব্যবহারকারী বা গুগল চ্যাট অ্যাপ কোনো স্পেসে আমন্ত্রিত, তার অংশ, নাকি অনুপস্থিত।

পূর্বশর্ত

নোড.জেএস

একজন ব্যবহারকারীকে একটি স্পেস থেকে অপসারণ করুন

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

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

ব্যবহারকারী প্রমাণীকরণ সহ একটি সদস্যপদ মুছে ফেলার পদ্ধতি নিচে দেওয়া হলো:

নোড.জেএস

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);
}

await main();

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

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

সফল হলে, রেসপন্স বডিতে 'state': 'NOT_A_MEMBER' সহ মেম্বারশিপটি ফেরত দেওয়া হয়, যা নির্দেশ করে যে সদস্যটি আর স্পেসটিতে নেই।

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

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

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

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

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

একটি স্ক্রিপ্ট লিখুন যা চ্যাট এপিআই কল করে

অ্যাপ অথেন্টিকেশন ব্যবহার করে মেম্বারশিপ ডিলিট করার পদ্ধতি নিচে দেওয়া হলো:

পাইথন

  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)

    # 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. কোডে নিম্নলিখিতটি প্রতিস্থাপন করুন:

    • SPACE : একটি স্পেসের নাম, যা আপনি চ্যাট এপিআই-এর spaces.list মেথড থেকে অথবা কোনো স্পেসের ইউআরএল থেকে পেতে পারেন।

    • MEMBER : একটি সদস্যপদের নাম, যা আপনি চ্যাট এপিআই (Chat API)-এর spaces.members.list মেথড থেকে পেতে পারেন। কোনো অ্যাপের সদস্যপদ মুছে ফেলার জন্য, MEMBER এর জায়গায় app লিখুন।

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_membership_delete_app.py

সফল হলে, রেসপন্স বডিতে 'state': 'NOT_A_MEMBER' সহ মেম্বারশিপটি ফেরত দেওয়া হয়, যা নির্দেশ করে যে সদস্যটি আর স্পেসটিতে নেই।

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

Google Workspace প্রশাসক হিসেবে কোনো স্পেস থেকে ব্যবহারকারী বা Google Groups অপসারণ করুন

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

গুগল ওয়ার্কস্পেস প্রশাসক হিসেবে এই পদ্ধতিটি কল করতে, নিম্নলিখিতগুলি করুন:

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

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

সীমাবদ্ধতা এবং বিবেচ্য বিষয়

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