Class GroupsApp

GruplarUygulaması

Bu sınıf, Google Gruplar bilgilerine erişim sağlar. Bir grubun e-posta adresi veya kullanıcının doğrudan üyesi olduğu grupların listesi gibi bilgileri sorgulamak için kullanılabilir.

Geçerli kullanıcının kaç grubun üyesi olduğunu gösteren bir örnek aşağıda verilmiştir:

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

Özellikler

MülkTürAçıklama
RoleRole

Yöntemler

YöntemDönüş türüKısa açıklama
getGroupByEmail(email)GroupBelirtilen e-posta adresine sahip grubu alır.
getGroups()Group[]Doğrudan üyesi (veya bekleyen üyesi) olduğunuz tüm grupları alır.

Ayrıntılı dokümanlar

getGroupByEmail(email)

Belirtilen e-posta adresine sahip grubu alır. Grup mevcut değilse veya grubu görme izniniz yoksa istisna oluşturur.

Aşağıda, bir grubu e-posta adresine göre alan ve mevcut kullanıcının üye olup olmadığını gösteren bir örnek verilmiştir. Çalıştırmadan önce örnek e-posta adresini gerçek bir grubun e-posta adresiyle değiştirin.

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.');
}

Parametreler

AdTürAçıklama
emailStringAlınacak grubun e-posta adresi.

Return

Group: Belirtilen e-posta adresine sahip grup.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getGroups()

Doğrudan üyesi (veya bekleyen üyesi) olduğunuz tüm grupları alır. Hiçbir grupta değilseniz bu liste boş olur. Grup mevcut değilse veya grubu görme izniniz yoksa istisna oluşturur.

Kullanıcının ait olduğu her grubun e-posta adresinin nasıl yazdırılacağına dair bir örnek aşağıda verilmiştir:

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 grubunun üyesiyseniz ve B grubu da A grubunun üyesiyse A grubuna dolaylı olarak abone olursunuz. "Üst" A grubuna gönderilen iletilerin kopyalarını alsanız bile aslında bu gruba abone değilsinizdir.

Döndürülen grupların mevcut veya beklemedeki bir üyesi olup olmadığınızı belirlemek için Group.getRole(email) değerini kullanabilirsiniz.

Return

Group[]: Kullanıcının doğrudan üyesi olduğu grupların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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