Method: spaces.create

• एचटीटीपी अनुरोध
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक
• इसे आज़माएं!

इससे स्पेस बनाया जाता है. इसका इस्तेमाल, नाम वाला स्पेस बनाने या Import mode में ग्रुप चैट बनाने के लिए किया जा सकता है. उदाहरण के लिए, स्पेस बनाना लेख देखें.

यह, पुष्टि के इन तरीकों के साथ काम करता है:

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

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces

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

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड वाले स्पेस के लिए)

ऐप्लिकेशन के तौर पर पुष्टि करते समय, अनुरोध में space.customer फ़ील्ड सेट करना ज़रूरी है.

ऐप्लिकेशन के तौर पर पुष्टि करते समय, Chat ऐप्लिकेशन को स्पेस के सदस्य के तौर पर जोड़ा जाता है. हालांकि, उपयोगकर्ता की पुष्टि के उलट, Chat ऐप्लिकेशन को स्पेस के मैनेजर के तौर पर नहीं जोड़ा जाता. डिफ़ॉल्ट रूप से, स्पेस के सभी सदस्य, Chat ऐप्लिकेशन को स्पेस से हटा सकते हैं. सिर्फ़ स्पेस के मैनेजर को किसी स्पेस से ऐप्लिकेशन हटाने की अनुमति देने के लिए, space.permission_settings.manage_apps को managersAllowed पर सेट करें.

स्पेस बनाने पर, उसकी सदस्यता इस बात पर निर्भर करती है कि स्पेस को Import mode में बनाया गया है या नहीं:

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

अगर स्पेस बनाते समय, आपको ALREADY_EXISTS गड़बड़ी का मैसेज मिलता है, तो कोई दूसरा displayName आज़माएं. ऐसा हो सकता है कि Google Workspace संगठन में मौजूद कोई स्पेस, पहले से ही इस डिसप्ले नेम का इस्तेमाल कर रहा हो.

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

POST https://chat.googleapis.com/v1/spaces

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

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

पैरामीटर

requestId

string ज़रूरी नहीं. यह अनुरोध के लिए यूनीक आईडी है. रैंडम यूयूआईडी का सुझाव दिया जाता है. अनुरोध आईडी तय करने से, अनुरोध को आइटमपोटेंट बनाया जा सकता है. इससे यह पक्का होता है कि एक ही अनुरोध आईडी वाले एक जैसे कई अनुरोध करने पर, सिर्फ़ एक स्पेस बनाया जाए. एक ही अनुरोध आईडी वाले बाद के अनुरोधों से, मौजूदा स्पेस दिखता है. साथ ही, स्पेस अपडेट नहीं होता. भले ही, अनुरोध की गई जानकारी, मौजूदा स्थिति से अलग हो. इस फ़ील्ड का असरदार तरीके से इस्तेमाल करने के लिए: पक्का करें कि बाद के अनुरोध, ओरिजनल अनुरोध जैसे ही हों और उनमें पुष्टि के लिए एक ही क्रेडेंशियल का इस्तेमाल किया गया हो. अगर दिए गए अनुरोध आईडी से कोई स्पेस पहले ही बनाया जा चुका है, तो अनुरोध से वह स्पेस दिखता है. ध्यान दें कि दिखने वाला स्पेस पूरी तरह से भरा हुआ नहीं हो सकता. एपीआई, आपके अनुरोध में मौजूद स्पेस को, सिस्टम से असाइन किए गए संसाधन के नाम के साथ दिखाता है. स्पेस के लिए, सबसे नया मेटाडेटा पाने के लिए, spaces.get को कॉल करें. पुष्टि किए गए किसी दूसरे उपयोगकर्ता के साथ, मौजूदा अनुरोध आईडी का फिर से इस्तेमाल करने पर गड़बड़ी होती है.

अनुरोध का मुख्य हिस्सा

अनुरोध के मुख्य भाग में Space का उदाहरण है.

जवाब का मुख्य हिस्सा

अनुरोध सही से काम करने पर, जवाब के मुख्य हिस्से में Space का नया इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

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

• https://www.googleapis.com/auth/chat.app.spaces.create
• https://www.googleapis.com/auth/chat.app.spaces
• https://www.googleapis.com/auth/chat.import
• https://www.googleapis.com/auth/chat.spaces
• https://www.googleapis.com/auth/chat.spaces.create

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