Class GroupsApp

GroupsApp

Dieser Kurs bietet Zugriff auf Google Groups-Informationen. Damit können Informationen wie die E-Mail-Adresse einer Gruppe oder die Liste der Gruppen abgefragt werden, in denen der Nutzer ein direktes Mitglied ist.

Das folgende Beispiel zeigt, in wie vielen Gruppen der aktuelle Nutzer Mitglied ist:

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

Attribute

PropertyTypBeschreibung
RoleRole

Methoden

MethodeRückgabetypKurzbeschreibung
getGroupByEmail(email)GroupRuft die Gruppe mit der angegebenen E-Mail-Adresse ab.
getGroups()Group[]Ruft alle Gruppen ab, bei denen Sie ein direktes (oder ein ausstehendes Mitglied) sind.

Detaillierte Dokumentation

getGroupByEmail(email)

Ruft die Gruppe mit der angegebenen E-Mail-Adresse ab. Löst eine Ausnahme aus, wenn die Gruppe nicht vorhanden ist oder Sie nicht berechtigt sind, sie anzusehen.

Im folgenden Beispiel wird eine Gruppe anhand ihrer E-Mail-Adresse abgerufen und ausgegeben, ob der aktuelle Nutzer Mitglied ist. Ersetzen Sie vor der Ausführung die Beispiel-E-Mail-Adresse durch die E-Mail-Adresse einer echten Gruppe.

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

Parameter

NameTypBeschreibung
emailStringDie E-Mail-Adresse der Gruppe, die abgerufen werden soll.

Return

Group: Die Gruppe mit der angegebenen E-Mail-Adresse.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getGroups()

Ruft alle Gruppen ab, bei denen Sie ein direktes (oder ein ausstehendes Mitglied) sind. Dies ist eine leere Liste, wenn Sie in keiner Gruppe sind. Löst eine Ausnahme aus, wenn die Gruppe nicht vorhanden ist oder Sie nicht berechtigt sind, sie anzusehen.

Hier sehen Sie ein Beispiel dafür, wie die E-Mail-Adresse für jede Gruppe, zu der der Nutzer gehört, gedruckt wird:

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);
}
Wenn Sie Mitglied der Gruppe B sind, die selbst Mitglied einer anderen Gruppe (A) ist, sind Sie indirekt Mitglied der Gruppe A. Auch wenn Sie Kopien der Nachrichten erhalten, die an die übergeordnete Gruppe A gesendet wurden, sind Sie dieser Gruppe nicht beigetreten.

Mit Group.getRole(email) können Sie feststellen, ob Sie ein vorhandenes oder ausstehendes Mitglied der zurückgegebenen Gruppen sind.

Return

Group[]: Die Liste der Gruppen, in denen der Nutzer ein direktes Mitglied ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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