Method: spaces.members.create

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

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

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

    • 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

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