स्पेस से किसी सदस्य को हटाना

इस गाइड में, Google Chat API के Membership संसाधन पर delete() तरीके का इस्तेमाल करके, किसी स्पेस से सदस्यों को हटाने का तरीका बताया गया है. इसे सदस्यता मिटाना भी कहा जाता है. अगर किसी स्पेस में सिर्फ़ एक स्पेस मैनेजर है, तो उसे हटाया नहीं जा सकता. इन मेंबरशिप को हटाने से पहले, किसी दूसरे उपयोगकर्ता को स्पेस मैनेजर की भूमिका असाइन करें.

अगर आप Google Workspace एडमिन हैं, तो आपके पास Google Workspace संगठन के किसी भी स्पेस से उपयोगकर्ताओं, Google ग्रुप या Chat ऐप्लिकेशन को हटाने का विकल्प होता है.

Membership संसाधन से पता चलता है कि किसी व्यक्ति या Google Chat ऐप्लिकेशन को किसी स्पेस में शामिल होने का न्योता मिला है या नहीं. इससे यह भी पता चलता है कि वह स्पेस में शामिल है या नहीं.

ज़रूरी शर्तें

Node.js

आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.

अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, नाम, आइकॉन, और जानकारी के साथ Google Chat API चालू करें और उसे कॉन्फ़िगर करें.
- Node.js Cloud Client Library इंस्टॉल करें.
- Google Chat API के अनुरोध में पुष्टि करने के तरीके के आधार पर, ऐक्सेस क्रेडेंशियल बनाएं:
  - Chat उपयोगकर्ता के तौर पर पुष्टि करने के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इसके बाद, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में credentials.json नाम की JSON फ़ाइल के तौर पर सेव करें.
  - Chat ऐप्लिकेशन के तौर पर पुष्टि करने के लिए, सेवा खाते के क्रेडेंशियल बनाएं और क्रेडेंशियल को credentials.json नाम की JSON फ़ाइल के तौर पर सेव करें.
अनुमति का स्कोप चुनें. यह इस बात पर निर्भर करता है कि आपको उपयोगकर्ता के तौर पर पुष्टि करनी है या Chat ऐप्लिकेशन के तौर पर.

Google Chat स्पेस. Google Chat API का इस्तेमाल करके स्पेस बनाने के लिए, स्पेस बनाना लेख पढ़ें. Chat में कोई टास्क बनाने के लिए, सहायता केंद्र के दस्तावेज़ पर जाएं.

किसी सदस्य को स्पेस से उपयोगकर्ता के तौर पर हटाना

उपयोगकर्ता की पुष्टि करने की सुविधा वाले स्पेस से किसी उपयोगकर्ता, Google ग्रुप या Chat ऐप्लिकेशन को हटाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:

chat.memberships ऑथराइज़ेशन स्कोप तय करें. अनुमति देने वाले उपयोगकर्ता के पास, किसी उपयोगकर्ता या Google ग्रुप को स्पेस से हटाने की अनुमति होनी चाहिए. Chat ऐप्लिकेशन को हटाने के लिए, chat.memberships.app अनुमति का दायरा तय करें. ऐप्लिकेशन सिर्फ़ अपनी सदस्यता मिटा सकते हैं, न कि दूसरे ऐप्लिकेशन की. सबसे सही तरीका यह है कि आप सबसे सीमित स्कोप चुनें, ताकि आपका ऐप्लिकेशन काम कर सके.
DeleteMembership() तरीके को कॉल करें.
जिस सदस्यता को मिटाना है उसका name पास करें. अगर सदस्यता किसी स्पेस के सिर्फ़ स्पेस मैनेजर के पास है, तो इस सदस्यता को मिटाने से पहले किसी दूसरे उपयोगकर्ता को स्पेस मैनेजर के तौर पर असाइन करें.

उपयोगकर्ता की पुष्टि की सुविधा वाली सदस्यता मिटाने का तरीका यहां बताया गया है:

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js

GitHub पर देखें

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() तरीके को कॉल करें या स्पेस के यूआरएल से आईडी पाएं.
MEMBER_NAME: सदस्य के name से मिला आईडी. ListMemberships() तरीके का इस्तेमाल करके, आईडी पाया जा सकता है.

अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में 'state': 'NOT_A_MEMBER' के साथ सदस्यता की जानकारी दिखती है. इससे पता चलता है कि सदस्य अब स्पेस में नहीं है.

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

Chat ऐप्लिकेशन के तौर पर किसी सदस्य को स्पेस से हटाना

ऐप्लिकेशन की पुष्टि करने के लिए, एडमिन की एक बार की अनुमति ज़रूरी है.

ऐप्लिकेशन की पुष्टि करने की सुविधा वाले स्पेस से किसी उपयोगकर्ता, Google ग्रुप या Chat ऐप्लिकेशन को हटाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:

chat.app.memberships अनुमति का दायरा तय करें. स्पेस मैनेजर की सदस्यता मिटाने की सुविधा, सिर्फ़ Chat ऐप्लिकेशन से बनाए गए स्पेस में काम करती है.
membership संसाधन पर delete तरीके को कॉल करें.
जिस सदस्यता को मिटाना है उसका name पास करें. अगर सदस्यता किसी स्पेस के सिर्फ़ स्पेस मैनेजर के पास है, तो इस सदस्यता को मिटाने से पहले किसी दूसरे उपयोगकर्ता को स्पेस मैनेजर के तौर पर असाइन करें.

Chat API को कॉल करने वाली स्क्रिप्ट लिखना

ऐप्लिकेशन से पुष्टि करने की सुविधा का इस्तेमाल करके ली गई सदस्यता मिटाने का तरीका यहां बताया गया है:

Python

अपनी वर्किंग डायरेक्ट्री में, chat_membership_delete_app.py नाम की एक फ़ाइल बनाएं.

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()

कोड में, इनकी जगह ये डालें:
- SPACE: स्पेस का नाम. इसे Chat API में spaces.list तरीके से या स्पेस के यूआरएल से पाया जा सकता है.
- MEMBER: सदस्यता का नाम. इसे Chat API में spaces.members.list तरीके से हासिल किया जा सकता है. किसी ऐप्लिकेशन की सदस्यता मिटाने के लिए, MEMBER को app से बदलें.
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और उसे चलाएं:
```
python3 chat_membership_delete_app.py
```

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

Google Workspace एडमिन के तौर पर, किसी स्पेस से उपयोगकर्ताओं या Google ग्रुप को हटाना

अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन के किसी भी स्पेस से उपयोगकर्ताओं, Google ग्रुप या Chat ऐप्लिकेशन को हटाने के लिए, DeleteMembership() तरीके का इस्तेमाल किया जा सकता है.

Google Workspace एडमिन के तौर पर इस तरीके को कॉल करने के लिए, यह तरीका अपनाएं:

उपयोगकर्ता की पुष्टि करने के लिए, इस तरीके को कॉल करें. साथ ही, अनुमति का दायरा तय करें. इससे एडमिन के अधिकारों का इस्तेमाल करके, इस तरीके को कॉल किया जा सकता है.
अपने अनुरोध में, क्वेरी पैरामीटर useAdminAccess को true पर सेट करें.

ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर Google Chat स्पेस मैनेज करना लेख पढ़ें.

सीमाएं और ज़रूरी बातें

ऐप्लिकेशन की पुष्टि करने की सुविधा की मदद से, Chat ऐप्लिकेशन उपयोगकर्ताओं को हटा सकता है. हालांकि, वह Google Groups या Chat ऐप्लिकेशन को नहीं हटा सकता.

ज़रूरी शर्तें

Node.js

किसी सदस्य को स्पेस से उपयोगकर्ता के तौर पर हटाना

Node.js

Chat ऐप्लिकेशन के तौर पर किसी सदस्य को स्पेस से हटाना

Chat API को कॉल करने वाली स्क्रिप्ट लिखना

Python

Google Workspace एडमिन के तौर पर, किसी स्पेस से उपयोगकर्ताओं या Google ग्रुप को हटाना

सीमाएं और ज़रूरी बातें

मिलते-जुलते विषय