इस गाइड में बताया गया है कि Google Chat API के Space
संसाधन पर delete()
तरीके का इस्तेमाल करके, नाम वाले स्पेस को कैसे मिटाया जा सकता है. ऐसा तब किया जाता है, जब स्पेस की ज़रूरत न हो. किसी स्पेस को मिटाने पर, उसमें मौजूद सभी आइटम भी मिट जाते हैं. इनमें मैसेज और अटैचमेंट शामिल हैं.
अगर आप Google Workspace एडमिन हैं, तो delete()
तरीके का इस्तेमाल करके, अपने Google Workspace संगठन में मौजूद किसी भी स्पेस को मिटाया जा सकता है.
Space
संसाधन
एक ऐसी जगह होती है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (डीएम), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
- ग्रुप चैट, तीन या उससे ज़्यादा लोगों और चैट ऐप्लिकेशन के बीच होने वाली बातचीत होती है.
- नाम वाले स्पेस, ऐसी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.
ज़रूरी शर्तें
Node.js
- आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- अपने Chat ऐप्लिकेशन के लिए, Google Chat API चालू करें और उसे कॉन्फ़िगर करें. इसके लिए, Chat ऐप्लिकेशन का नाम, आइकॉन, और जानकारी दें.
- Node.js Cloud Client Library इंस्टॉल करें.
-
डेस्कटॉप ऐप्लिकेशन के लिए, OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. इस गाइड में दिए गए सैंपल को चलाने के लिए, क्रेडेंशियल को अपनी लोकल डायरेक्ट्री में
credentials.json
नाम की JSON फ़ाइल के तौर पर सेव करें.
- अनुमति का ऐसा दायरा चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा के साथ काम करता हो.
- Google Chat स्पेस. Google Chat API का इस्तेमाल करके स्पेस बनाने के लिए, स्पेस बनाना लेख पढ़ें. Chat में कोई टास्क बनाने के लिए, सहायता केंद्र के दस्तावेज़ पर जाएं.
उपयोगकर्ता के तौर पर, नाम वाला स्पेस मिटाना
उपयोगकर्ता की पुष्टि करने की सुविधा के साथ Google Chat में मौजूद किसी स्पेस को मिटाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:
chat.delete
ऑथराइज़ेशन स्कोप तय करें.DeleteSpace()
तरीके को कॉल करें.- मिटाने के लिए, स्पेस का
name
पास करें.
स्पेस मिटाने का तरीका यहां बताया गया है:
Node.js
इस सैंपल को चलाने के लिए, SPACE_NAME
को स्पेस के name
फ़ील्ड से मिले आईडी से बदलें. आईडी पाने के लिए, ListSpaces()
तरीके का इस्तेमाल करें या स्पेस के यूआरएल से आईडी पाएं.
किसी चैट ऐप्लिकेशन के तौर पर, नाम वाला स्पेस मिटाना
इस प्रोग्राम में शामिल होने पर, आपको कुछ सुविधाओं को रिलीज़ होने से पहले ही इस्तेमाल करने का ऐक्सेस मिलता है.ऐप्लिकेशन की पुष्टि करने के लिए, एडमिन की एक बार की अनुमति ज़रूरी है.
ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके, सिर्फ़ Chat ऐप्लिकेशन से बनाए गए स्पेस मिटाए जा सकते हैं.
ऐप्लिकेशन की पुष्टि की सुविधा वाले Google Chat स्पेस को मिटाने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:
chat.app.delete
ऑथराइज़ेशन स्कोप तय करें.Space
संसाधन परdelete
तरीके को कॉल करें.- मिटाने के लिए, स्पेस का
name
पास करें.
एपीआई पासकोड बनाना
डेवलपर प्रीव्यू एपीआई के तरीके को कॉल करने के लिए, आपको एपीआई डिस्कवरी दस्तावेज़ के डेवलपर प्रीव्यू वर्शन का इस्तेमाल करना होगा. यह वर्शन सार्वजनिक नहीं होता. अनुरोध की पुष्टि करने के लिए, आपको एपीआई पासकोड डालना होगा.
एपीआई पासकोड बनाने के लिए, अपने ऐप्लिकेशन का Google Cloud प्रोजेक्ट खोलें और यह तरीका अपनाएं:
- Google Cloud console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.
- क्रेडेंशियल बनाएं > एपीआई कुंजी पर क्लिक करें.
- आपको नई एपीआई कुंजी दिखेगी.
- अपने ऐप्लिकेशन के कोड में इस्तेमाल करने के लिए, एपीआई पासकोड कॉपी करने के लिए, कॉपी करें पर क्लिक करें. एपीआई पासकोड, आपके प्रोजेक्ट के क्रेडेंशियल के "एपीआई पासकोड" सेक्शन में भी देखा जा सकता है.
- एपीआई पासकोड के इस्तेमाल को सीमित करने और ऐडवांस सेटिंग अपडेट करने के लिए, कुंजी के इस्तेमाल पर पाबंदी लगाएं पर क्लिक करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदियां लगाना लेख पढ़ें.
Chat API को कॉल करने वाली स्क्रिप्ट लिखना
स्पेस मिटाने का तरीका यहां बताया गया है:
Python
- अपनी वर्किंग डायरेक्ट्री में,
chat_space_delete_app.py
नाम की एक फ़ाइल बनाएं. 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()
कोड में, इनकी जगह ये डालें:
API_KEY
: Chat API के लिए, सेवा एंडपॉइंट बनाने के लिए बनाया गया एपीआई पासकोड.SPACE
स्पेस के नाम के साथ. इसे Chat API मेंspaces.list
तरीके से या स्पेस के यूआरएल से पाया जा सकता है.
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और उसे चलाएं:
python3 chat_space_delete_app.py
अगर अनुरोध पूरा हो जाता है, तो जवाब का मुख्य हिस्सा खाली होता है. इससे पता चलता है कि स्पेस मिटा दिया गया है.
Google Workspace एडमिन के तौर पर, नाम वाले स्पेस को मिटाना
अगर आप Google Workspace एडमिन हैं, तो अपने Google Workspace संगठन में मौजूद किसी भी स्पेस को मिटाने के लिए, DeleteSpace()
तरीके का इस्तेमाल किया जा सकता है.
Google Workspace एडमिन के तौर पर इस तरीके को कॉल करने के लिए, यह तरीका अपनाएं:
- उपयोगकर्ता की पुष्टि करने के लिए, इस तरीके का इस्तेमाल करें. साथ ही, अनुमति का दायरा तय करें. इससे एडमिन के अधिकारों का इस्तेमाल करके, इस तरीके को कॉल किया जा सकेगा.
- अपने अनुरोध में, क्वेरी पैरामीटर
useAdminAccess
कोtrue
पर सेट करें.
ज़्यादा जानकारी और उदाहरणों के लिए, Google Workspace एडमिन के तौर पर Google Chat स्पेस मैनेज करना लेख पढ़ें.
मिलते-जुलते विषय
- कोई स्पेस बनाएं
- किसी स्पेस के बारे में जानकारी पाना.
- स्पेस की सूची.
- स्पेस अपडेट करना.
- किसी स्पेस को मिटाना.
- कोई स्पेस सेट अप करना.
- डायरेक्ट मैसेज वाला स्पेस ढूंढें.