Method: spaces.members.list

स्पेस में, पैसे चुकाकर ली जाने वाली सदस्यताओं की सूची दिखाता है. उदाहरण के लिए, स्पेस में उपयोगकर्ताओं और Google Chat ऐप्लिकेशन की सूची बनाना लेख पढ़ें. ऐप्लिकेशन की पुष्टि करने वाली लिस्टिंग में, उन स्पेस की पैसे चुकाकर ली जाने वाली सदस्यताओं की जानकारी शामिल होती है जिनका ऐक्सेस Chat ऐप्लिकेशन के पास होता है. हालांकि, इसमें Chat ऐप्लिकेशन की पैसे चुकाकर ली जाने वाली सदस्यताएं और उस पर मिलने वाली सदस्यताएं शामिल नहीं होतीं. उपयोगकर्ता की पुष्टि करने की सुविधा के साथ स्टोर पेज की सदस्यताएं, उन स्पेस के लिए सदस्यताओं की सूची बनाती हैं जिनका ऐक्सेस पुष्टि किए गए उपयोगकर्ता के पास है.

इसके लिए, पुष्टि करना ज़रूरी है. ऐप्लिकेशन की पुष्टि करने और उपयोगकर्ता की पुष्टि करने की सुविधा देता है.

एचटीटीपी अनुरोध

GET https://chat.googleapis.com/v1/{parent=spaces/*}/members

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. उस स्पेस का संसाधन नाम जिसके लिए सदस्यता की सूची फ़ेच करनी है.

फ़ॉर्मैट: Spaces/{space}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

ज़रूरी नहीं. ज़्यादा से ज़्यादा इतने सदस्यों को लौटाया जा सकता है. सेवा, इस वैल्यू से कम वैल्यू दिखा सकती है.

अगर इनकी जानकारी नहीं दी जाती है, तो ज़्यादा से ज़्यादा 100 सदस्यताएं वापस की जाती हैं.

वैल्यू ज़्यादा से ज़्यादा 1,000 हो सकती है. अगर आपने 1,000 से ज़्यादा की वैल्यू इस्तेमाल की है, तो वह अपने-आप 1000 में बदल जाती है.

नेगेटिव वैल्यू दिखाने पर INVALID_ARGUMENT गड़बड़ी दिखती है.

pageToken

string

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

पेजों को क्रम में लगाते समय, दिए गए अन्य सभी पैरामीटर, उस कॉल से मेल खाने चाहिए जो पेज टोकन दिया गया था. दूसरे पैरामीटर में अलग-अलग वैल्यू पास करने पर, अनचाहे नतीजे मिल सकते हैं.

filter

string

ज़रूरी नहीं. क्वेरी का फ़िल्टर.

सदस्यताओं को सदस्य की भूमिका (role) और टाइप (member.type) के हिसाब से फ़िल्टर किया जा सकता है.

भूमिका के हिसाब से फ़िल्टर करने के लिए, role को ROLE_MEMBER या ROLE_MANAGER पर सेट करें.

टाइप के हिसाब से फ़िल्टर करने के लिए, member.type को HUMAN या BOT पर सेट करें.

भूमिका और टाइप, दोनों के हिसाब से फ़िल्टर करने के लिए, AND ऑपरेटर का इस्तेमाल करें. भूमिका या टाइप के हिसाब से फ़िल्टर करने के लिए, OR ऑपरेटर का इस्तेमाल करें.

उदाहरण के लिए, नीचे दी गई क्वेरी मान्य हैं:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

ये क्वेरी अमान्य हैं:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

सर्वर अमान्य क्वेरी को INVALID_ARGUMENT गड़बड़ी के साथ अस्वीकार कर देता है.

showGroups

boolean

ज़रूरी नहीं. जब true, अन्य तरह की सदस्यताओं के साथ-साथ Google Group से जुड़ी सदस्यताएं भी दिखाता है, तो. अगर filter सेट है, तो Google Group की ऐसी सदस्यताएं नहीं दिखाई जाएंगी जो फ़िल्टर की शर्तों से मेल नहीं खातीं.

showInvited

boolean

ज़रूरी नहीं. true होने पर, अन्य तरह की सदस्यताओं के साथ-साथ, invited के सदस्यों से जुड़ी सदस्यताएं भी दिखती हैं. अगर कोई फ़िल्टर सेट किया गया है, तो invited की ऐसी सदस्यताएं नहीं दिखाई जाएंगी जो फ़िल्टर की शर्तों से मेल नहीं खातीं.

फ़िलहाल, इसके लिए उपयोगकर्ता की पुष्टि करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
memberships[]

object (Membership)

बिना क्रम वाली सूची. अनुरोध किए गए (या पहले) पेज पर, पैसे चुकाकर ली जाने वाली सदस्यताओं की सूची.

nextPageToken

string

ऐसा टोकन जिसे pageToken के तौर पर भेजा जा सकता है, ताकि नतीजों का अगला पेज वापस मिल सके. अगर खाली है, तो इसके बाद कोई पेज नहीं है.

अनुमति के दायरे

इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

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