REST Resource: spaces.members

संसाधन: सदस्यता

यह Google Chat में सदस्यता के बारे में बताता है. जैसे, किसी उपयोगकर्ता या Chat ऐप्लिकेशन को किसी स्पेस में शामिल होने का न्योता मिला है, वह स्पेस का हिस्सा है या नहीं.

JSON के काेड में दिखाना 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,
  "affiliation": enum (Affiliation),

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. सर्वर की ओर से असाइन की गई सदस्यता का संसाधन नाम.

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

enum (MembershipState)

सिर्फ़ आउटपुट के लिए. पैसे चुकाकर ली जाने वाली सदस्यता की स्थिति.
role

enum (MembershipRole)

ज़रूरी नहीं. Chat स्पेस में उपयोगकर्ता की भूमिका. इससे यह तय होता है कि उपयोगकर्ता, स्पेस में कौनसी कार्रवाइयां कर सकता है.

इस फ़ील्ड का इस्तेमाल सिर्फ़ members.patch में इनपुट के तौर पर किया जा सकता है.
createTime

string (Timestamp format)

ज़रूरी नहीं. इम्यूटेबल. सदस्यता बनाने का समय. जैसे, कोई सदस्य किसी स्पेस में कब शामिल हुआ या उसे कब शामिल होने का न्योता मिला. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में, सदस्यता का पुराना डेटा इंपोर्ट करने के लिए किया जा सकता है.
deleteTime

string (Timestamp format)

ज़रूरी नहीं. इम्यूटेबल. सदस्यता मिटाने का समय. जैसे, जब कोई सदस्य किसी स्पेस को छोड़ता है या उसे स्पेस से हटाया जाता है. यह फ़ील्ड सिर्फ़ आउटपुट के लिए होता है. हालांकि, इसका इस्तेमाल इंपोर्ट मोड वाले स्पेस में, सदस्यता का पुराना डेटा इंपोर्ट करने के लिए किया जा सकता है.
affiliation

enum (Affiliation)

सिर्फ़ आउटपुट के लिए. स्पेस का मालिकाना हक रखने वाले Workspace संगठन के साथ उपयोगकर्ता का संबंध. उपयोगकर्ता खातों के मालिकाना हक वाले स्पेस में, सभी सदस्यों का अफ़िलिएशन EXTERNAL होता है.
यूनियन फ़ील्ड memberType. इस सदस्यता से जुड़ा सदस्य. आने वाले समय में, अन्य तरह के सदस्यों के लिए भी यह सुविधा उपलब्ध हो सकती है. memberType इनमें से सिर्फ़ एक हो सकता है:
member

object (User)

ज़रूरी नहीं. Google Chat का वह उपयोगकर्ता या ऐप्लिकेशन जिसकी सदस्यता है. अगर आपका Chat ऐप्लिकेशन, उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट, उपयोगकर्ता name और type को भरता है.
groupMember

object (Group)

ज़रूरी नहीं. Google ग्रुप, जिससे सदस्यता जुड़ी है.

Google Groups के लिए, सदस्यताएं पढ़ने या उनमें बदलाव करने के लिए उपयोगकर्ता की पुष्टि करना ज़रूरी है.

MembershipState

इससे स्पेस में सदस्य की भूमिका के बारे में पता चलता है. आने वाले समय में, सदस्यता की अन्य स्थितियां भी जोड़ी जा सकती हैं.

Enums
MEMBERSHIP_STATE_UNSPECIFIED डिफ़ॉल्ट मान. इसका इस्तेमाल न करें.
JOINED उपयोगकर्ता को स्पेस में शामिल कर दिया जाता है. इसके बाद, वह स्पेस में हिस्सा ले सकता है.
INVITED उपयोगकर्ता को स्पेस में शामिल होने का न्योता भेजा गया है, लेकिन वह शामिल नहीं हुआ है.
NOT_A_MEMBER उपयोगकर्ता, स्पेस का सदस्य नहीं है. साथ ही, उसे स्पेस में शामिल होने का न्योता नहीं मिला है.

MembershipRole

इससे पता चलता है कि कोई उपयोगकर्ता, Chat स्पेस में कौनसी कार्रवाइयां कर सकता है. आने वाले समय में, इसमें और एनम वैल्यू जोड़ी जा सकती हैं.

Enums
MEMBERSHIP_ROLE_UNSPECIFIED डिफ़ॉल्ट मान. users के लिए: यह व्यक्ति स्पेस का सदस्य नहीं है, लेकिन इसे न्योता भेजा जा सकता है. Google Groups के लिए: उन्हें हमेशा यह भूमिका असाइन की जाती है. हालांकि, आने वाले समय में अन्य enum वैल्यू का इस्तेमाल किया जा सकता है.
ROLE_MEMBER

स्पेस का सदस्य. Chat के यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को सदस्य कहा जाता है.

उपयोगकर्ता के पास बुनियादी अनुमतियां हों, जैसे कि स्पेस में मैसेज भेजने की अनुमति. मैनेजर और मालिक, सदस्यों को स्पेस में ये अतिरिक्त अनुमतियां दे सकते हैं:

  • सदस्यों को जोड़ना या हटाना.
  • स्पेस की जानकारी में बदलाव करना.
  • इतिहास को चालू या बंद करें.
  • @all का इस्तेमाल करके, स्पेस के सभी सदस्यों का नाम टैग करें.
  • स्पेस में इंस्टॉल किए गए Chat ऐप्लिकेशन और वेबुक मैनेज करें.

डायरेक्ट मैसेज और बिना नाम वाली ग्रुप बातचीत में, सभी के पास यह भूमिका होती है.
ROLE_MANAGER

स्पेस का मालिक हो. चैट यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को मालिक कहा जाता है.

उपयोगकर्ता के पास स्पेस को मैनेज करने के लिए, स्पेस से जुड़ी सभी अनुमतियां होनी चाहिए. जैसे:

  • स्पेस में मौजूद अन्य सदस्यों की भूमिका को सदस्य, मैनेजर या मालिक के तौर पर बदलना.
  • स्पेस मिटाएं.

यह सिर्फ़ SpaceType.SPACE (नाम वाली जगहें) में काम करता है.

ज़्यादा जानने के लिए, स्पेस के मालिक या मैनेजर की भूमिका के बारे में ज़्यादा जानें लेख पढ़ें.
ROLE_ASSISTANT_MANAGER

स्पेस मैनेजर हो. Chat के यूज़र इंटरफ़ेस (यूआई) में, इस भूमिका को मैनेजर कहा जाता है.

उपयोगकर्ता के पास ROLE_MEMBER की सभी बुनियादी अनुमतियां होती हैं. साथ ही, मालिक उसे एडमिन की कुछ अनुमतियां दे सकता है. डिफ़ॉल्ट रूप से, मैनेजर के पास मालिक की सभी अनुमतियां होती हैं. हालांकि, वह ये काम नहीं कर सकता:

  • स्पेस मिटाएं.
  • स्पेस के किसी दूसरे सदस्य को मालिक बनाना.
  • मालिक की भूमिका बदलना.

डिफ़ॉल्ट रूप से, मैनेजर के पास ये अनुमतियां होती हैं. हालांकि, इनके अलावा और भी अनुमतियां हो सकती हैं:

  • किसी दूसरे सदस्य को मैनेजर बनाएं.
  • स्पेस में मौजूद मैसेज मिटाना.
  • स्पेस की अनुमतियां मैनेज करना.
  • अगर मैनेजर के पास स्पेस की सेटिंग में "सदस्यों को मैनेज करें" अनुमति है, तो उसे स्पेस में शामिल होने के अनुरोधों की सूचनाएं मिलती हैं.
  • स्पेस को सभी सदस्यों के लिए उपलब्ध कराएं.

यह सिर्फ़ SpaceType.SPACE (नाम वाली जगहें) में काम करता है.

ज़्यादा जानने के लिए, स्पेस की सेटिंग मैनेज करना लेख पढ़ें.

ग्रुप

Google Chat में मौजूद कोई Google ग्रुप.

JSON के काेड में दिखाना 
{
  "name": string
}
फ़ील्ड
name

string

Google ग्रुप के संसाधन का नाम.

यह Cloud Identity Groups API में ग्रुप को दिखाता है.

फ़ॉर्मैट: groups/{group}

संबद्धता

इससे पता चलता है कि उपयोगकर्ता, Google Workspace का इस्तेमाल करने वाले उस संगठन से जुड़ा है जिसके पास स्पेस का मालिकाना हक है. आने वाले समय में, इस enum में और वैल्यू जोड़ी जा सकती हैं.

Enums
AFFILIATION_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
INTERNAL ऐसा खाता जिसे स्पेस का मालिक Google Workspace संगठन मैनेज करता है.
EXTERNAL स्पेस के मालिक Google Workspace संगठन से बाहर का खाता. जैसे, उपभोक्ता खाता या किसी दूसरे Workspace संगठन से मैनेज किया जाने वाला खाता.
MANAGED_EXTERNAL यह ऐसा खाता होता है जिसे स्पेस का मालिक Workspace संगठन मैनेज करता है. हालांकि, इसे संगठन से बाहर के किसी उपयोगकर्ता (जैसे, मेहमान उपयोगकर्ता) के लिए उपलब्ध कराया जाता है. मेहमानों के बारे में ज़्यादा जानने के लिए, https://support.google.com/chat/answer/16997417 पर जाएं.

तरीके

create

 यह Chat ऐप्लिकेशन, किसी उपयोगकर्ता या Google ग्रुप के लिए सदस्यता बनाता है.

delete

 यह कुकी, सदस्यता को मिटाती है.

get

 यह फ़ंक्शन, किसी सदस्यता के बारे में जानकारी दिखाता है.

list

 किसी स्पेस में मौजूद सदस्यताओं की सूची दिखाता है.

patch

 सदस्यता को अपडेट करता है.