REST Resource: spaces.members

संसाधन: पैसे चुकाकर ली जाने वाली सदस्यता

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 होता है.
इस सदस्यता से जुड़ा सदस्य. आने वाले समय में, अन्य तरह के सदस्यों के लिए भी यह सुविधा उपलब्ध हो सकती है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

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