Method: spaces.members.create

कॉल करने वाले Chat ऐप्लिकेशन, किसी उपयोगकर्ता या Google ग्रुप के लिए सदस्यता बनाता है. Chat के अलावा, दूसरे चैट ऐप्लिकेशन के लिए पैसे चुकाकर ली जाने वाली सदस्यताएं नहीं बनाई जा सकतीं. सदस्यता बनाते समय, अगर किसी सदस्य ने अपने-आप स्वीकार होने की नीति बंद कर दी है, तो उसे न्योता भेजा जाता है. स्पेस में शामिल होने से पहले, उसे न्योता स्वीकार करना होगा. अगर ऐसा नहीं किया जाता है, तो सदस्यता बनाने पर, सदस्य को सीधे उस स्पेस में जोड़ दिया जाता है.

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

  • डेवलपर प्रीव्यू में, एडमिन की अनुमति के साथ ऐप्लिकेशन की पुष्टि और अनुमति का दायरा:

    • https://www.googleapis.com/auth/chat.app.memberships

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

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (स्पेस में कॉल करने वाला ऐप्लिकेशन जोड़ने के लिए)
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड में स्पेस)
    • उपयोगकर्ता की पुष्टि करने पर, एडमिन खाते को एडमिन की अनुमतियां मिलती हैं. ऐसा तब होता है, जब useAdminAccess true हो और अनुमति के लिए इस दायरे का इस्तेमाल किया गया हो:
      • https://www.googleapis.com/auth/chat.admin.memberships

ऐप्लिकेशन की पुष्टि करने की सुविधा, इन इस्तेमाल के उदाहरणों के लिए काम नहीं करती:

  • स्पेस का मालिकाना हक रखने वाले Workspace संगठन से बाहर के लोगों को न्योता भेजना.
  • किसी स्पेस में Google ग्रुप जोड़ना.
  • किसी स्पेस में Chat ऐप्लिकेशन जोड़ना.

इस्तेमाल के उदाहरण के लिए, ये देखें:

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

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. उस स्पेस का नाम जिसके लिए सदस्यता बनानी है.

फ़ॉर्मैट: spaces/{space}

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

पैरामीटर
useAdminAccess

boolean

ज़रूरी नहीं. true होने पर, यह तरीका उपयोगकर्ता के Google Workspace एडमिन के विशेषाधिकारों का इस्तेमाल करके चलता है.

कॉल करने वाला व्यक्ति, Google Workspace का एडमिन होना चाहिए. साथ ही, उसके पास चैट और स्पेस में होने वाली बातचीत को मैनेज करने का ऐक्सेस होना चाहिए.

इसके लिए, chat.admin.memberships OAuth 2.0 स्कोप की ज़रूरत होती है.

एडमिन ऐक्सेस का इस्तेमाल करके, ऐप्लिकेशन की सदस्यताएं नहीं बनाई जा सकतीं. इसके अलावा, एडमिन के Google Workspace संगठन से बाहर के उपयोगकर्ताओं के लिए भी सदस्यताएं नहीं बनाई जा सकतीं.

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

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

जवाब का मुख्य भाग

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

अनुमति के दायरे

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

  • https://www.googleapis.com/auth/chat.app.memberships
  • 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

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