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)

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

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

createTime

string (Timestamp format)

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

deleteTime

string (Timestamp format)

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

यूनियन फ़ील्ड 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 के लिए: उन्हें हमेशा यह भूमिका असाइन की जाती है. आने वाले समय में, अन्य वैल्यू का इस्तेमाल किया जा सकता है.
ROLE_MEMBER स्पेस का सदस्य. उपयोगकर्ता के पास स्पेस में मैसेज भेजने जैसी बुनियादी अनुमतियां होती हैं. 1:1 और बिना नाम वाले ग्रुप बातचीत में, सभी लोगों के पास यह भूमिका होती है.
ROLE_MANAGER स्पेस मैनेजर. उपयोगकर्ता के पास सभी बुनियादी अनुमतियां के साथ-साथ एडमिन की ऐसी अनुमतियां भी होती हैं जिनसे वह स्पेस को मैनेज कर सकता है. जैसे- सदस्यों को जोड़ना या हटाना. यह सिर्फ़ SpaceType.SPACE में काम करता है.

ग्रुप

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

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

string

किसी Google ग्रुप के लिए संसाधन का नाम.

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

फ़ॉर्मैट: ग्रुप/{group}

तरीके

create

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

delete

पैसे चुकाकर ली गई सदस्यता मिटाता है.

get

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

list

यह विकल्प, स्पेस में पैसे चुकाकर ली जाने वाली सदस्यताओं की सूची दिखाता है.

patch

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