Class Group

ग्रुप

ग्रुप ऑब्जेक्ट, जिसके सदस्यों और ग्रुप में उनकी भूमिकाओं के बारे में क्वेरी की जा सकती है.

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

function listGroupMembers() {
  const group = GroupsApp.getGroupByEmail('[e-mail]');
  console.log(`${group.getEmail()}:`);
  const users = group.getUsers();
  for (let i = 0; i < users.length; i++) {
    const user = users[i];
    console.log(user.getEmail());
  }
}

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
getEmail()	String	इस ग्रुप का ईमेल पता मिलता है.
getGroups()	Group[]	यह ग्रुप के डायरेक्ट चाइल्ड ग्रुप को वापस लाता है.
getRole(email)	Role	यह कुकी, ग्रुप के हिसाब से उपयोगकर्ता की भूमिका को वापस पाती है.
getRole(user)	Role	यह कुकी, ग्रुप के हिसाब से उपयोगकर्ता की भूमिका को वापस पाती है.
getRoles(users)	Role[]	यह कुकी, ग्रुप के हिसाब से उपयोगकर्ताओं की भूमिकाएं वापस लाती है.
getUsers()	User[]	यह फ़ंक्शन, ग्रुप के उन सदस्यों और प्रतिबंधित सदस्यों की जानकारी देता है जिनके पास Google खाता है.
hasGroup(group)	Boolean	इस फ़ंक्शन से यह पता चलता है कि कोई ग्रुप, इस ग्रुप का सीधे तौर पर सदस्य है या नहीं.
hasGroup(email)	Boolean	इस फ़ंक्शन से यह पता चलता है कि कोई ग्रुप, इस ग्रुप का सीधे तौर पर सदस्य है या नहीं.
hasUser(email)	Boolean	इस कुकी से यह पता चलता है कि कोई उपयोगकर्ता, ग्रुप का डायरेक्ट सदस्य है या नहीं.
hasUser(user)	Boolean	इस कुकी से यह पता चलता है कि कोई उपयोगकर्ता, ग्रुप का डायरेक्ट सदस्य है या नहीं.

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

getEmail()

इस ग्रुप का ईमेल पता मिलता है.

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

function listMyGroupEmails() {
  const groups = GroupsApp.getGroups();
  for (let i = 0; i < groups.length; i++) {
    console.log(groups[i].getEmail());
  }
}

वापसी का टिकट

String — ग्रुप का ईमेल पता.

अनुमति देना

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

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

---

getGroups()

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

इस तरीके के अलावा, किसी डोमेन में ग्रुप के सदस्यों की जानकारी पाने के लिए, Admin SDK Directory की ऐडवांस सेवा का इस्तेमाल किया जा सकता है.

function listGroupMembers() {
  const GROUP_EMAIL = '[e-mail]';
  const group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  const childGroups = group.getGroups();
  console.log(`Group ${GROUP_EMAIL} has ${childGroups.length} groups:`);
  for (let i = 0; i < childGroups.length; i++) {
    const childGroup = childGroups[i];
    console.log(childGroup.getEmail());
  }
}

वापसी का टिकट

Group[] — ग्रुप के सभी डायरेक्ट चाइल्ड ग्रुप.

अनुमति देना

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

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

---

getRole(email)

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

इस उदाहरण में, किसी ग्रुप के मालिकों की सूची दी गई है:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  const user = users[i];
  if (group.getRole(user.getEmail()) === GroupsApp.Role.OWNER) {
    console.log(user.getEmail());
  }
}

पैरामीटर

नाम	टाइप	ब्यौरा
email	String	उपयोगकर्ता का ईमेल पता.

वापसी का टिकट

Role — ग्रुप में उस उपयोगकर्ता की भूमिका.

अनुमति देना

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

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

---

getRole(user)

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

इस उदाहरण में, किसी ग्रुप के मालिकों की सूची दी गई है:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  const user = users[i];
  if (group.getRole(user) === GroupsApp.Role.OWNER) {
    console.log(user.getEmail());
  }
}

पैरामीटर

नाम	टाइप	ब्यौरा
user	User	वह उपयोगकर्ता जिसकी भूमिका वापस लानी है.

वापसी का टिकट

Role — ग्रुप में उस उपयोगकर्ता की भूमिका.

अनुमति देना

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

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

इन्हें भी देखें

• getRole(email)

---

getRoles(users)

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

इस उदाहरण में, किसी ग्रुप के मालिकों की सूची दी गई है:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
const roles = group.getRoles(users);
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  if (roles[i] === GroupsApp.Role.OWNER) {
    console.log(users[i].getEmail());
  }
}

पैरामीटर

नाम	टाइप	ब्यौरा
users	User[]	वे उपयोगकर्ता जिनकी भूमिकाओं के लिए अनुरोध किया गया है.

वापसी का टिकट

Role[] — ग्रुप में उन उपयोगकर्ताओं की भूमिकाएं.

अनुमति देना

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

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

---

getUsers()

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

ध्यान दें: अगर आप ग्रुप B के सदस्य हैं और ग्रुप B, ग्रुप A का सदस्य है, तो आपने ग्रुप A की सदस्यता सीधे तौर पर नहीं ली है. आपको इस ग्रुप में भेजे गए मैसेज की कॉपी मिलती है. हालांकि, आपने पैरंट ग्रुप A की सदस्यता नहीं ली है.

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

function listGroupMembers() {
  const GROUP_EMAIL = '[e-mail]';
  const group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  const users = group.getUsers();
  console.log(`Group ${GROUP_EMAIL} has ${users.length} members:`);
  for (let i = 0; i < users.length; i++) {
    const user = users[i];
    console.log(user.getEmail());
  }
}

इस तरीके के अलावा, किसी डोमेन में ग्रुप के सदस्यों की जानकारी पाने के लिए, Admin SDK Directory की ऐडवांस सेवा का इस्तेमाल किया जा सकता है.

वापसी का टिकट

User[] — ग्रुप के सभी डायरेक्ट सदस्य.

अनुमति देना

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

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

---

hasGroup(group)

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

const group = GroupsApp.getGroupByEmail('[e-mail]');
const childGroup = GroupsApp.getGroupByEmail('[e-mail]');
if (group.hasGroup(childGroup)) {
  console.log('[e-mail] is a child group');
}

पैरामीटर

नाम	टाइप	ब्यौरा
group	Group	वह ग्रुप जिसकी सदस्यता की जांच करनी है.

वापसी का टिकट

Boolean — true अगर वह ग्रुप इस ग्रुप का चाइल्ड ग्रुप है; false ऐसा न होने पर.

अनुमति देना

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

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

---

hasGroup(email)

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

const group = GroupsApp.getGroupByEmail('[e-mail]');
if (group.hasGroup('[e-mail]')) {
  console.log('[e-mail] is a child group');
}

पैरामीटर

नाम	टाइप	ब्यौरा
email	String	किसी ग्रुप का ईमेल पता.

वापसी का टिकट

Boolean — true अगर वह ग्रुप इस ग्रुप का चाइल्ड ग्रुप है; false ऐसा न होने पर.

अनुमति देना

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

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

---

hasUser(email)

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

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

const group = GroupsApp.getGroupByEmail('[e-mail]');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser.getEmail())) {
  console.log('You are a member');
}

पैरामीटर

नाम	टाइप	ब्यौरा
email	String	उपयोगकर्ता का ईमेल पता.

वापसी का टिकट

Boolean — अगर उपयोगकर्ता ग्रुप का सदस्य है, तो true; अगर नहीं है, तो false.

अनुमति देना

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

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

---

hasUser(user)

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

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

const group = GroupsApp.getGroupByEmail('[e-mail]');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  console.log('You are a member');
}

पैरामीटर

नाम	टाइप	ब्यौरा
user	User	वह उपयोगकर्ता जिसकी सदस्यता की जांच करनी है.

वापसी का टिकट

Boolean — अगर उपयोगकर्ता ग्रुप का सदस्य है, तो true; अगर नहीं है, तो false.

अनुमति देना

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

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