Class GroupsApp

GroupsApp

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

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

var groups = GroupsApp.getGroups();
Logger.log('You belong to ' + groups.length + ' groups.');

प्रॉपर्टी

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

तरीके

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

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

getGroupByEmail(email)

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

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

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var 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.");
}

पैरामीटर

नामTypeब्यौरा
emailStringजिस ग्रुप को वापस लाना है उसका ईमेल पता.

रिटर्न

Group — बताया गया ईमेल पते वाला ग्रुप.

अनुमति देना

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

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

getGroups()

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

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

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

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

रिटर्न

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

अनुमति देना

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

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