Class GroupsApp

GroupsApp

इस क्लास से, Google Groups की जानकारी ऐक्सेस की जा सकती है. इसका इस्तेमाल, ग्रुप के ईमेल पते या उन ग्रुप की सूची जैसी जानकारी के लिए क्वेरी करने के लिए किया जा सकता है जिनमें उपयोगकर्ता सीधे तौर पर सदस्य है.

यहां एक उदाहरण दिया गया है, जिसमें दिखाया गया है कि मौजूदा उपयोगकर्ता कितने ग्रुप का सदस्य है: 

const groups = GroupsApp.getGroups();
Logger.log(`You belong to ${groups.length} groups.`);

प्रॉपर्टी

प्रॉपर्टीटाइपब्यौरा
RoleRole

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getGroupByEmail(email)Groupयह तरीका, दिए गए ईमेल पते वाले ग्रुप की जानकारी दिखाता है.
getGroups()Group[]यह तरीका, उन सभी ग्रुप की जानकारी दिखाता है जिनमें आप सीधे तौर पर सदस्य हैं या जिनके लिए आपने सदस्यता का अनुरोध किया है.

ज़्यादा जानकारी वाला दस्तावेज़

getGroupByEmail(email)

यह तरीका, दिए गए ईमेल पते वाले ग्रुप की जानकारी दिखाता है. अगर ग्रुप मौजूद नहीं है या आपके पास उसे देखने की अनुमति नहीं है, तो यह तरीका एक अपवाद दिखाता है.

यहां एक उदाहरण दिया गया है, जिसमें किसी ग्रुप को उसके ईमेल पते से ऐक्सेस किया जाता है और यह दिखाया जाता है कि मौजूदा उपयोगकर्ता उस ग्रुप का सदस्य है या नहीं. उदाहरण को चलाने से पहले, सैंपल ईमेल पते को किसी असल ग्रुप के ईमेल पते से बदलें. 

const group = GroupsApp.getGroupByEmail('example@googlegroups.com');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  Logger.log('You are a member of this group.');
} else {
  Logger.log('You are not a member of this group.');
}

पैरामीटर

नामटाइपब्यौरा
emailStringयह उस ग्रुप का ईमेल पता है जिसकी जानकारी आपको चाहिए.

वापसी का टिकट

Group — यह दिए गए ईमेल पते वाला ग्रुप है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/groups

getGroups()

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

यहां एक उदाहरण दिया गया है, जिसमें उपयोगकर्ता के सभी ग्रुप के ईमेल पते प्रिंट किए जाते हैं: 

function showMyGroups() {
  const groups = GroupsApp.getGroups();
  let str = `You are in ${groups.length} groups: `;
  for (let i = 0; i < groups.length; i++) {
    const group = groups[i];
    str = `${str + group.getEmail()} `;
  }
  Logger.log(str);
}
 ध्यान दें कि अगर आप ग्रुप B के सदस्य हैं और ग्रुप B, ग्रुप A का सदस्य है, तो आपने ग्रुप A की सदस्यता अप्रत्यक्ष तौर पर ली है. भले ही, आपको "पैरंट" ग्रुप A को भेजे गए मैसेज की कॉपी मिलती हों, लेकिन आपने असल में उस ग्रुप की सदस्यता नहीं ली होती.

यह पता लगाने के लिए कि आप दिखाए गए ग्रुप के मौजूदा सदस्य हैं या आपने सदस्यता का अनुरोध किया है, Group.getRole(email) का इस्तेमाल किया जा सकता है.

वापसी का टिकट

Group[] — यह उन ग्रुप की सूची है जिनमें उपयोगकर्ता सीधे तौर पर सदस्य है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/groups