किसी स्पेस को मिटाना

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

अगर आप Google Workspace एडमिन हैं, तो आपके पास अपने Google Workspace संगठन में, नाम वाले किसी स्पेस को मिटाने के लिए, delete() तरीके को कॉल करने का विकल्प होता है.

Space संसाधन, एक ऐसी जगह को दिखाता है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:

  • डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
  • ग्रुप चैट में तीन या उससे ज़्यादा उपयोगकर्ता और चैट ऐप्लिकेशन के बीच बातचीत होती है.
  • नाम वाले स्पेस, हमेशा मौजूद रहते हैं. इनमें लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.

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

Node.js

  • आपके पास ऐसा Business या Enterprise Google Workspace खाता होना चाहिए जिसके पास Google Chat का ऐक्सेस हो.

उपयोगकर्ता के तौर पर, नाम वाले स्पेस को मिटाना

Google Chat में मौजूद किसी मौजूदा स्पेस को उपयोगकर्ता की पुष्टि के साथ मिटाने के लिए, अपने अनुरोध में ये चीज़ें डालें:

  • chat.delete अनुमति का स्कोप बताएं.
  • DeleteSpace() तरीके का इस्तेमाल करें.
  • मिटाए जाने वाले स्पेस का 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() तरीका अपनाएं या स्पेस के यूआरएल का इस्तेमाल करें.

Chat ऐप्लिकेशन के तौर पर, नाम वाले स्पेस को मिटाना

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

ऐप्लिकेशन की पुष्टि करने की सुविधा की मदद से, सिर्फ़ चैट ऐप्लिकेशन से बनाए गए स्पेस मिटाए जा सकते हैं.

ऐप्लिकेशन की पुष्टि की मदद से, Google Chat में मौजूद किसी स्पेस को मिटाने के लिए, अपने अनुरोध में ये चीज़ें डालें:

  • chat.app.delete अनुमति का स्कोप बताएं.
  • Space संसाधन पर, delete तरीके को कॉल करें.
  • मिटाने के लिए, name स्पेस को पास करें.

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

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

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

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

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

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

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

स्पेस मिटाने का तरीका यहां बताया गया है:

Python

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

  2. chat_space_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.delete"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified space.
    '''

    # 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().delete(

          # The space 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.
          name='spaces/SPACE'

      ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a space, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. कोड में, इनकी जगह ये डालें:

    • API_KEY: Chat API के लिए सेवा एंडपॉइंट बनाने के लिए, आपने जो एपीआई पासकोड बनाया है.

    • SPACE में स्पेस का नाम डालें. यह नाम, Chat API में spaces.list तरीके या स्पेस के यूआरएल से लिया जा सकता है.

  4. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:

    python3 chat_space_delete_app.py

अगर स्पेस मिटा दिया जाता है, तो जवाब का मुख्य हिस्सा खाली होता है. इससे पता चलता है कि स्पेस मिटा दिया गया है.

Google Workspace एडमिन के तौर पर बनाए गए स्पेस को मिटाना

अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन में मौजूद किसी भी नाम वाले स्पेस को मिटाने के लिए, DeleteSpace() तरीका अपनाएं.

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

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

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