Class Group

Grup

Üyeleri ve bu üyelerin öğeleri içeren grup nesnesi gruptaki roller sorgulanabilir.

Aşağıda, bir grubun üyelerini gösteren bir örnek verilmiştir. Çalıştırmadan önce e-postayı grubun, alanınızdaki bir tanesinin adresiyle aynı olmalıdır.

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

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getEmail()	String	Bu grubun e-posta adresini alır.
getGroups()	Group[]	Grubun doğrudan alt gruplarını alır.
getRole(email)	Role	Grup bağlamında bir kullanıcının rolünü alır.
getRole(user)	Role	Grup bağlamında bir kullanıcının rolünü alır.
getRoles(users)	Role[]	Kullanıcıların bilgilerini alır rollerin bir listesini yapar.
getUsers()	User[]	Grubun bilinen, karşılık gelen bir Google Hesabı'na sahip doğrudan üyelerini alır.
hasGroup(group)	Boolean	Bir grubun, bu grubun doğrudan üyesi olup olmadığını test eder.
hasGroup(email)	Boolean	Bir grubun, bu grubun doğrudan üyesi olup olmadığını test eder.
hasUser(email)	Boolean	Kullanıcının grubun doğrudan bir üyesi olup olmadığını test eder.
hasUser(user)	Boolean	Kullanıcının grubun doğrudan bir üyesi olup olmadığını test eder.

Ayrıntılı belgeler

getEmail()

Bu grubun e-posta adresini alır.

Bu örnekte, kullanıcının ait olduğu tüm grupların e-posta adresi listelenmektedir.

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

Return

String: Grubun e-posta adresi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

getGroups()

Grubun doğrudan alt gruplarını alır. grubun üye listesini görüntüleme izni.

Bu yönteme ek olarak Admin SDK Directory gelişmiş hizmetini kullanarak bir alandaki grup üyelerini alır.

function listGroupMembers() {
  var GROUP_EMAIL = "[e-mail]";
  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());
  }
}

Return

Group[]: Grubun tüm doğrudan alt grupları.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

getRole(email)

Grup bağlamında bir kullanıcının rolünü alır. Bir grubun doğrudan üyesi olan kullanıcı tam olarak bir role sahip. Kullanıcı grubuna veya grubun üye listesini görüntüleme izninizin olup olmadığına bakın.

Bu örnekte bir grubun sahipleri listelenmiştir:

var group = GroupsApp.getGroupByEmail("[e-mail]");
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());
  }
}

Parametreler

Ad	Tür	Açıklama
email	String	Kullanıcının e-posta adresi.

Return

Role — Bu kullanıcının grup içindeki rolü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

getRole(user)

Grup bağlamında bir kullanıcının rolünü alır. Bir grubun doğrudan üyesi olan kullanıcı tam olarak bir role sahip. Kullanıcı grubuna veya grubun üye listesini görüntüleme izninizin olup olmadığına bakın.

Bu örnekte bir grubun sahipleri listelenmiştir:

var group = GroupsApp.getGroupByEmail("[e-mail]");
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());
  }
}

Parametreler

Ad	Tür	Açıklama
user	User	Rolünü alınacak kullanıcı.

Return

Role — Bu kullanıcının grup içindeki rolü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• getRole(email)

---

getRoles(users)

Kullanıcıların bilgilerini alır rollerin bir listesini yapar. Bir grubun doğrudan üyesi olan kullanıcı tam olarak bir role sahip. Herhangi bir kullanıcı grubuna veya grubun üye listesini görüntüleme izninizin olup olmadığına bakın.

Bu örnekte bir grubun sahipleri listelenmiştir:

var group = GroupsApp.getGroupByEmail("[e-mail]");
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());
  }
}

Parametreler

Ad	Tür	Açıklama
users	User[]	Rolleri istenen kullanıcılar.

Return

Role[] — Bu kullanıcıların grup içindeki rolleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

getUsers()

Grubun bilinen, karşılık gelen bir Google Hesabı'na sahip doğrudan üyelerini alır. Şunu atar: bu istisnayı kullanabilirsiniz.

Not: Kendisi başka bir A grubunun üyesi olan B grubunun üyesiyseniz A grubuna dolaylı olarak abonedir. Şu adrese gönderilen iletilerin kopyalarını alabilirsiniz: A üst grubuna abone olmazsınız.

Aşağıda, bir grubun üyelerini gösteren bir örnek verilmiştir. Çalıştırmadan önce e-postayı grubun, alanınızdaki bir tanesinin adresiyle aynı olmalıdır.

function listGroupMembers() {
  var GROUP_EMAIL = "[e-mail]";
  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());
  }
}

Bu yönteme ek olarak Admin SDK Directory gelişmiş hizmetini kullanarak bir alandaki grup üyelerini alır.

Return

User[] — Grubun tüm doğrudan üyeleri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

hasGroup(group)

Bir grubun, bu grubun doğrudan üyesi olup olmadığını test eder. Bu yöntem, şu durumda true değerini döndürmez: test edilen grup, bu grubun birden fazla seviye altında iç içe yerleştirilmiştir. Aşağıdaki durumda bir istisna verir grubun üye listesini görüntüleme izni yok.

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

Parametreler

Ad	Tür	Açıklama
group	Group	Üyeliğini test edilecek grup.

Return

Boolean — Bu grup, bu grubun alt gruplarıysa true; Aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

hasGroup(email)

Bir grubun, bu grubun doğrudan üyesi olup olmadığını test eder. Bu yöntem, şu durumda true değerini döndürmez: test edilen grup, bu grubun birden fazla seviye altında iç içe yerleştirilmiştir. Aşağıdaki durumda bir istisna verir grubun üye listesini görüntüleme izni yok.

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

Parametreler

Ad	Tür	Açıklama
email	String	Bir grubun e-posta adresi.

Return

Boolean — Bu grup, bu grubun alt gruplarıysa true; Aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

hasUser(email)

Kullanıcının grubun doğrudan bir üyesi olup olmadığını test eder. grubun üye listesini görüntüleme izni.

Geçerli kullanıcının bir grubun üyesi olup olmadığını kontrol eden bir örneği aşağıda bulabilirsiniz:

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

Parametreler

Ad	Tür	Açıklama
email	String	Kullanıcının e-posta adresi.

Return

Boolean — Söz konusu kullanıcı grubun üyesiyse true; Aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

---

hasUser(user)

Kullanıcının grubun doğrudan bir üyesi olup olmadığını test eder. grubun üye listesini görüntüleme izni.

Geçerli kullanıcının bir grubun üyesi olup olmadığını kontrol eden bir örneği aşağıda bulabilirsiniz:

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

Parametreler

Ad	Tür	Açıklama
user	User	Üyeliği test edilecek kullanıcı.

Return

Boolean — Söz konusu kullanıcı grubun üyesiyse true; Aksi takdirde false.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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