Method: spaces.delete

इस तरीके का इस्तेमाल करके, नाम वाला स्पेस मिटाया जाता है. यह हमेशा कैस्केडिंग डिलीट करता है. इसका मतलब है कि स्पेस के चाइल्ड रिसॉर्स भी मिट जाते हैं. जैसे, स्पेस में पोस्ट किए गए मैसेज और स्पेस की सदस्यताएं. उदाहरण के लिए, स्पेस मिटाना लेख पढ़ें.

इन तरह के authentication के साथ काम करता है:

  • एडमिन की मंज़ूरी और अनुमति के दायरे के साथ ऐप्लिकेशन की पुष्टि करना:

    • https://www.googleapis.com/auth/chat.app.delete (सिर्फ़ उन स्पेस में जिन्हें ऐप्लिकेशन ने बनाया है)

  • उपयोगकर्ता की पुष्टि के लिए, अनुमति के इन स्कोप में से किसी एक का इस्तेमाल करें:

    • https://www.googleapis.com/auth/chat.delete
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस)
    • उपयोगकर्ता की पुष्टि करने पर, एडमिन के अधिकारों को अनुमति मिलती है. ऐसा तब होता है, जब एडमिन खाता पुष्टि करता है, useAdminAccess true होता है, और अनुमति के इस स्कोप का इस्तेमाल किया जाता है:
      • https://www.googleapis.com/auth/chat.admin.delete

एचटीटीपी अनुरोध

DELETE https://chat.googleapis.com/v1/{name=spaces/*}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. मिटाए जाने वाले स्पेस का संसाधन नाम.

फ़ॉर्मैट: spaces/{space}

क्वेरी पैरामीटर

पैरामीटर
useAdminAccess

boolean

ज़रूरी नहीं. true होने पर, यह तरीका उपयोगकर्ता के Google Workspace एडमिन के अधिकारों का इस्तेमाल करके काम करता है.

कॉल करने वाला व्यक्ति, Google Workspace एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.

इसके लिए, chat.admin.delete OAuth 2.0 स्कोप की ज़रूरत होती है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में एक खाली JSON ऑब्जेक्ट होता है.

अनुमति के स्कोप

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.