- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
कॉल के लिए इस्तेमाल होने वाले ऐप्लिकेशन के लिए, मैन्युअल तौर पर या ऐप्लिकेशन के लिए सदस्यता बनाई जाती है. अन्य ऐप्लिकेशन के लिए, पैसे चुकाकर ली जाने वाली सदस्यताएं नहीं बनाई जा सकतीं. उदाहरण के लिए, किसी उपयोगकर्ता या Google Chat ऐप्लिकेशन को स्पेस में जोड़ना या न्योता भेजना लेख पढ़ें. सदस्यता बनाते समय, अगर किसी सदस्य ने अपने-आप स्वीकार करने की सुविधा की नीति बंद की है, तो उसे न्योता भेजा जाता है. साथ ही, शामिल होने से पहले उसे स्पेस का न्योता स्वीकार करना होगा. अगर ऐसा नहीं किया जाता है, तो पैसे चुकाकर ली जाने वाली सदस्यता लेने पर, सदस्य को सीधे तौर पर तय किए गए स्पेस में जोड़ दिया जाता है. उपयोगकर्ता की पुष्टि ज़रूरी है.
सदस्य को जोड़ने के लिए, व्यक्ति या ऐप्लिकेशन सदस्य के लिए membership.member.name
सेट करें या ग्रुप के सदस्य के लिए membership.group_member.name
सेट करें.
कॉल के लिए इस्तेमाल होने वाले ऐप्लिकेशन को स्पेस में जोड़ने या दो लोगों के बीच डायरेक्ट मैसेज भेजने के लिए,
users/app
का इस्तेमाल करें. स्पेस में अन्य ऐप्लिकेशन नहीं जोड़े जा सके.किसी उपयोगकर्ता को जोड़ने के लिए,
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 ग्रुप को जोड़ने या न्योता भेजने के लिए,
groups/{group}
का इस्तेमाल करें. इसमें Cloud Identity Groups API से ग्रुप काid
मान{group}
है. उदाहरण के लिए, ग्रुप ईमेलgroup@example.com
का आईडी123456789
पाने के लिए, Cloud Identity Groups lookup API का इस्तेमाल किया जा सकता है. इसके बाद,membership.group_member.name
कोgroups/123456789
पर सेट करके, ग्रुप को नाम वाले स्पेस में जोड़ा या न्योता भेजा जा सकता है. ग्रुप का ईमेल पता इस्तेमाल नहीं किया जा सकता. साथ ही, Google ग्रुप को सिर्फ़ नाम वाले स्पेस में सदस्यों के तौर पर जोड़ा जा सकता है.
एचटीटीपी अनुरोध
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. स्पेस के संसाधन का नाम, जिसके लिए सदस्यता बनानी है. फ़ॉर्मैट: स्पेस/{space} |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
useAdminAccess |
true के साथ, यह तरीका उपयोगकर्ता के Google Workspace एडमिन के खास अधिकारों का इस्तेमाल करके चलता है.कॉल करने वाला उपयोगकर्ता, Google Workspace एडमिन होना चाहिए. उसके पास, चैट और स्पेस में होने वाली बातचीत को मैनेज करने का अधिकार होना चाहिए.
एडमिन ऐक्सेस का इस्तेमाल करके, एडमिन के Google Workspace खाते से बाहर के उपयोगकर्ताओं के लिए, ऐप्लिकेशन की सदस्यताएं बनाने या सदस्यताएं बनाने की सुविधा उपलब्ध नहीं है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Membership
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब होने पर, जवाब के मुख्य हिस्से में Membership
का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.