स्पेस बनाता है और उसमें चुनिंदा उपयोगकर्ताओं को जोड़ता है. कॉल करने वाले व्यक्ति को स्पेस में अपने-आप जोड़ दिया जाता है. इसे अनुरोध में, सदस्यता के तौर पर शामिल नहीं किया जाना चाहिए. उदाहरण के लिए, शुरुआती सदस्यों वाला स्पेस सेट अप करना देखें.
सदस्यों को जोड़ने के लिए, सही membership.member.name
के साथ सदस्यताएं जोड़ें. किसी उपयोगकर्ता को जोड़ने के लिए, users/{user}
का इस्तेमाल करें. यहां {user}
, उपयोगकर्ता का ईमेल पता हो सकता है. Workspace का इस्तेमाल करने वाले एक ही संगठन के उपयोगकर्ताओं के लिए, {user}
, People API का इस्तेमाल करने वाले व्यक्ति के लिए id
हो सकता है. इसके अलावा, डायरेक्ट्री एपीआई में उपयोगकर्ता के लिए id
भी हो सकता है. उदाहरण के लिए, अगर user@example.com
का पीपल एपीआई पर्सन प्रोफ़ाइल आईडी 123456789
है, तो membership.member.name
को users/user@example.com
या users/123456789
पर सेट करके उपयोगकर्ता को स्पेस में जोड़ा जा सकता है.
नाम वाले स्पेस या ग्रुप चैट में, अगर कॉलर को ब्लॉक किया जाता है, कुछ सदस्यों ने उसे ब्लॉक किया है या उसके पास कुछ सदस्यों को जोड़ने की अनुमति नहीं है, तो ऐसे सदस्यों को बनाए गए स्पेस में नहीं जोड़ा जाता.
कॉल करने वाले उपयोगकर्ता और दूसरे व्यक्ति के बीच डायरेक्ट मैसेज (DM) बनाने के लिए, उस उपयोगकर्ता की तरफ़ से एक ही सदस्यता तय करें. अगर कोई एक उपयोगकर्ता दूसरे को ब्लॉक करता है, तो अनुरोध पूरा नहीं होता और DM नहीं बनता.
कॉल करने वाले उपयोगकर्ता और कॉल करने वाले ऐप्लिकेशन के बीच डायरेक्ट मैसेज (DM) बनाने के लिए, Space.singleUserBotDm
को true
पर सेट करें और किसी सदस्यता के बारे में न बताएं. इस तरीके का इस्तेमाल, सिर्फ़ कॉल करने वाले ऐप्लिकेशन के साथ DM सेट अप करने के लिए किया जा सकता है. कॉल करने वाले ऐप्लिकेशन को स्पेस के सदस्य या दो लोगों के बीच मौजूदा DM सेट करने के लिए, स्पेस में उपयोगकर्ता या ऐप्लिकेशन को न्योता भेजना या जोड़ना लेख पढ़ें.
अगर दो उपयोगकर्ताओं के बीच पहले से ही कोई DM मौजूद है, तो फिर भी मौजूदा DM वापस आ जाता है. ऐसा तब भी होता है, जब कोई व्यक्ति अनुरोध करते समय एक-दूसरे को ब्लॉक करता है.
थ्रेड वाले जवाब की सुविधा वाले स्पेस का इस्तेमाल नहीं किया जा सकता. अगर स्पेस सेट अप करते समय, आपको गड़बड़ी का मैसेज ALREADY_EXISTS
मिलता है, तो कोई दूसरा displayName
आज़माकर देखें. Google Workspace संगठन में कोई मौजूदा स्पेस पहले से ही इस डिसप्ले नेम का इस्तेमाल कर सकता है.
इसके लिए, उपयोगकर्ता की पहचान की पुष्टि करना ज़रूरी है.
एचटीटीपी अनुरोध
POST https://chat.googleapis.com/v1/spaces:setup
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "space": { object ( |
फ़ील्ड | |
---|---|
space |
ज़रूरी है. स्पेस बनाने के लिए, ग्रुप चैट बनाने के लिए, लोगों के बीच 1:1 बातचीत करने के लिए, Chat ऐप्लिकेशन और किसी व्यक्ति के बीच 1:1 बातचीत करने के लिए, अगर |
requestId |
ज़रूरी नहीं. इस अनुरोध के लिए यूनीक आइडेंटिफ़ायर. एक रैंडम यूयूआईडी का सुझाव दिया जाता है. किसी मौजूदा अनुरोध आईडी को तय करने से, नया स्पेस बनाने के बजाय उस आईडी से बनाया गया स्पेस वापस आ जाता है. एक ही Chat ऐप्लिकेशन के किसी मौजूदा अनुरोध के आईडी को पुष्टि किए गए किसी अलग उपयोगकर्ता से तय करने पर गड़बड़ी का मैसेज मिलता है. |
memberships[] |
ज़रूरी नहीं. Google Chat इस्तेमाल करने वाले ऐसे लोग जिन्हें स्पेस में शामिल होने का न्योता देना है. कॉल करने वाले उपयोगकर्ता को छोड़ दें, क्योंकि उन्हें अपने-आप जोड़ दिया जाता है. फ़िलहाल, इस सेट में 20 सदस्यताएं (कॉलर के अलावा) तक शामिल की जा सकती हैं. मैन्युअल तौर पर ली जाने वाली सदस्यता के लिए,
जब किसी उपयोगकर्ता के साथ चैट ऐप्लिकेशन और किसी व्यक्ति के बीच 1:1 बातचीत करते समय यह फ़ील्ड खाली होना चाहिए (जब |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Space
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.create
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.