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