Method: spaces.create

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

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

ऐप्लिकेशन के तौर पर पुष्टि करते समय, अनुरोध में 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

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

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

अनुरोध के मुख्य भाग में 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

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