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

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

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

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

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

Node.js

  • कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.

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

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

  • chat.memberships की अनुमति के दायरे के बारे में बताएं. अनुमति देने वाले उपयोगकर्ता के पास, उपयोगकर्ता या Google ग्रुप को हटाने की अनुमति होनी चाहिए से हटा दिया गया है. Chat से किसी ऐप्लिकेशन को हटाने के लिए, 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() वाला तरीका अपनाकर या स्पेस के यूआरएल से, आईडी पाया जा सकता है.
  • 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 ऐप्लिकेशन के बनाए गए स्पेस में काम करते हैं.
  • delete तरीके को कॉल करें पूरी तरह कैसे membership संसाधन.
  • मिटाने के लिए, सदस्यता का name पास करें. अगर सदस्यता अगर स्पेस का कोई सदस्य नहीं है, तो पहले किसी दूसरे उपयोगकर्ता को स्पेस मैनेजर बनाएं इस सदस्यता को हटाया जा रहा है.

एपीआई पासकोड बनाना

डेवलपर झलक एपीआई तरीके को कॉल करने के लिए, आपको एपीआई खोज दस्तावेज़ के ऐसे वर्शन का इस्तेमाल करना होगा जो सार्वजनिक नहीं है. अनुरोध की पुष्टि करने के लिए, आपको एपीआई पासकोड डालना होगा.

एपीआई पासकोड बनाने के लिए, अपने ऐप्लिकेशन का Google Cloud प्रोजेक्ट खोलें और यह तरीका अपनाएं:

  1. Google Cloud console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.

    क्रेडेंशियल पर जाएं

  2. क्रेडेंशियल बनाएं पर क्लिक करें > एपीआई पासकोड.
  3. आपकी नई API (एपीआई) कुंजी दिखाई गई.
    • कॉपी करें पर क्लिक करें का इस्तेमाल करें. एपीआई पासकोड ये भी हो सकता है: "एपीआई पासकोड" में मिली जानकारी सेक्शन पर जाएं.
    • बेहतर सेटिंग अपडेट करने और एपीआई पासकोड के इस्तेमाल को सीमित करने के लिए, पासकोड पर पाबंदी लगाएं पर क्लिक करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदियां लगाना लेख पढ़ें.

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

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

Python

  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: Chat API के लिए सेवा एंडपॉइंट बनाने के लिए, आपने जो एपीआई पासकोड बनाया है.

    • 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 ग्रुप को हटाना

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

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

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

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