Class Group

گروه

یک شی گروه که اعضای آن و نقش آن اعضا در گروه قابل پرس و جو هستند.

در اینجا یک مثال است که اعضای یک گروه را نشان می دهد. قبل از اجرای آن، آدرس ایمیل گروه را با آدرس ایمیل دامنه خود جایگزین کنید.

function listGroupMembers() {
  var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
  console.log(group.getEmail() + ':');
  var users = group.getUsers();
  for (var i = 0; i < users.length; i++) {
    var 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() {
  var groups = GroupsApp.getGroups();
  for (var i = 0; i < groups.length; i++) {
    console.log(groups[i].getEmail());
  }
}

برگشت

String - آدرس ایمیل گروه.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

getGroups()

گروه های فرزند مستقیم گروه را بازیابی می کند. در صورتی که مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا می گذارد.

علاوه بر این روش، می توانید از سرویس پیشرفته Admin SDK Directory برای بازیابی اعضای گروه در یک دامنه استفاده کنید.

function listGroupMembers() {
  var GROUP_EMAIL = "example@googlegroups.com";
  var group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  var childGroups = group.getGroups();
  console.log("Group " + GROUP_EMAIL + " has " + childGroups.length + " groups:");
  for (var i = 0; i < childGroups.length; i++) {
    var childGroup = childGroups[i];
    console.log(childGroup.getEmail());
  }
}

برگشت

Group[] - همه گروه های فرزند مستقیم گروه.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

getRole(email)

نقش کاربر را در زمینه گروه بازیابی می کند. کاربری که عضو مستقیم یک گروه است دقیقاً یک نقش در آن گروه دارد. در صورتی که کاربر عضو گروه نباشد یا اگر مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا ایجاد می کند.

این مثال صاحبان یک گروه را فهرست می کند:

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var users = group.getUsers();
console.log('These are the group owners:');
for (var i = 0; i < users.length; i++) {
  var 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)

نقش کاربر را در زمینه گروه بازیابی می کند. کاربری که عضو مستقیم یک گروه است دقیقاً یک نقش در آن گروه دارد. در صورتی که کاربر عضو گروه نباشد یا اگر مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا ایجاد می کند.

این مثال صاحبان یک گروه را فهرست می کند:

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var users = group.getUsers();
console.log('These are the group owners:');
for (var i = 0; i < users.length; i++) {
  var user = users[i];
  if (group.getRole(user) == GroupsApp.Role.OWNER) {
    console.log(user.getEmail());
  }
}

مولفه های

نام تایپ کنید شرح
user User کاربری که نقش او بازیابی شود.

برگشت

Role - نقش آن کاربر در گروه.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

همچنین ببینید

getRoles(users)

نقش های کاربران را در زمینه گروه بازیابی می کند. کاربری که عضو مستقیم یک گروه است دقیقاً یک نقش در آن گروه دارد. در صورتی که کاربر عضو گروه نباشد یا شما اجازه مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا ایجاد می کند.

این مثال صاحبان یک گروه را فهرست می کند:

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var users = group.getUsers();
var roles = group.getRoles(users);
console.log('These are the group owners:');
for (var 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 هستید که خود عضو گروه A دیگری است، به طور غیرمستقیم مشترک گروه A هستید. اگرچه کپی هایی از پیام های ارسال شده به آن را دریافت می کنید، اما در واقع در گروه والد A مشترک نیستید.

در اینجا یک مثال است که اعضای یک گروه را نشان می دهد. قبل از اجرای آن، آدرس ایمیل گروه را با آدرس ایمیل دامنه خود جایگزین کنید.

function listGroupMembers() {
  var GROUP_EMAIL = "example@googlegroups.com";
  var group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  var users = group.getUsers();
  console.log("Group " + GROUP_EMAIL + " has " + users.length + " members:");
  for (var i = 0; i < users.length; i++) {
    var user = users[i];
    console.log(user.getEmail());
  }
}
علاوه بر این روش، می توانید از سرویس پیشرفته Admin SDK Directory برای بازیابی اعضای گروه در یک دامنه استفاده کنید.

برگشت

User[] - همه اعضای مستقیم گروه.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

hasGroup(group)

آزمایش می کند که آیا یک گروه عضو مستقیم این گروه است یا خیر. اگر گروه آزمایش شده بیش از یک سطح زیر این گروه تودرتو باشد، روش true برنمی گردد. در صورتی که مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا می گذارد.

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var childGroup = GroupsApp.getGroupByEmail("childgroup@googlegroups.com");
if (group.hasGroup(childGroup)) {
  console.log("childgroup@googlegroups.com is a child group");
}

مولفه های

نام تایپ کنید شرح
group Group گروهی که عضویت آن تست شود.

برگشت

Boolean - true اگر آن گروه، گروه فرزند این گروه باشد. false در غیر این صورت

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

hasGroup(email)

آزمایش می کند که آیا یک گروه عضو مستقیم این گروه است یا خیر. اگر گروه آزمایش شده بیش از یک سطح زیر این گروه تودرتو باشد، روش true برنمی گردد. در صورتی که مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا می گذارد.

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
if (group.hasGroup("childgroup@googlegroups.com")) {
  console.log("childgroup@googlegroups.com is a child group");
}

مولفه های

نام تایپ کنید شرح
email String آدرس ایمیل یک گروه

برگشت

Boolean - true اگر آن گروه، گروه فرزند این گروه باشد. false در غیر این صورت

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

hasUser(email)

آزمایش می کند که آیا کاربر عضو مستقیم گروه است یا خیر. در صورتی که مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا می گذارد.

در اینجا مثالی وجود دارد که بررسی می کند آیا کاربر فعلی عضو یک گروه است یا خیر:

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

آزمایش می کند که آیا کاربر عضو مستقیم گروه است یا خیر. در صورتی که مجوز مشاهده لیست اعضای گروه را نداشته باشید، یک استثنا می گذارد.

در اینجا مثالی وجود دارد که بررسی می کند آیا کاربر فعلی عضو یک گروه است یا خیر:

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  console.log("You are a member");
}

مولفه های

نام تایپ کنید شرح
user User کاربری که عضویتش را تست کنید.

برگشت

Boolean - true اگر آن کاربر یکی از اعضای گروه باشد. false در غیر این صورت

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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