REST Resource: spaces.members

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

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

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

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
फ़ील्ड
name

string

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

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

enum (MembershipState)

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

enum (MembershipRole)

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

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

string (Timestamp format)

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

string (Timestamp format)

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

object (User)

ज़रूरी नहीं. Google Chat का वह उपयोगकर्ता या ऐप्लिकेशन जिसकी सदस्यता है. अगर आपका Chat ऐप्लिकेशन उपयोगकर्ता के तौर पर पुष्टि करता है, तो आउटपुट में user 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

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

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

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

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

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

ग्रुप

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

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

string

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

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

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

तरीके

create

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

delete

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

get

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

list

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

patch

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