Class GroupsApp

GroupsApp

Dieser Kurs bietet Zugriff auf Google Groups-Informationen. Damit lassen sich Informationen wie als E-Mail-Adresse einer Gruppe oder die Liste der Gruppen, 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

Attribut	Typ	Beschreibung
Role	Role

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getGroupByEmail(email)	Group	Ruft die Gruppe mit der angegebenen E-Mail-Adresse ab.
getGroups()	Group[]	Ruft alle Gruppen ab, bei denen Sie ein direktes Mitglied (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 existieren oder Sie nicht berechtigt sind, sie anzuzeigen.

Hier ist ein Beispiel, das eine Gruppe anhand ihrer E-Mail-Adresse abruft und ausgibt, ob die aktuelle Nutzer ist Mitglied. Ersetzen Sie vor der Ausführung die Beispiel-E-Mail-Adresse durch die E-Mail-Adresse einer echten Gruppe.

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

Name	Typ	Beschreibung
email	String	Die E-Mail-Adresse der abzurufenden Gruppe.

Rückflug

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 Mitglied (oder ein ausstehendes Mitglied) sind. Dies ist ein leere Liste, wenn Sie keiner Gruppe angehören. Löst eine Ausnahme aus, wenn die Gruppe nicht vorhanden ist oder wenn Sie sind nicht berechtigt, sie anzuzeigen.

Hier ist ein Beispiel dafür, wie die E-Mail-Adresse für jede Gruppe, zu der der Nutzer gehört, ausgegeben 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 einer Gruppe sind, „B“, die wiederum Mitglied einer anderen Gruppe ist, gilt Folgendes: Sie sind der Gruppe A indirekt beigetreten. Auch wenn Sie Kopien der Nachrichten erhalten, an das übergeordnete Element gesendet, Gruppe A haben Sie diese Gruppe nicht wirklich abonniert.

Mit Group.getRole(email) können Sie feststellen, ob es sich um einen bestehenden oder ausstehenden Mitglied der zurückgegebenen Gruppen.

Rückflug

Group[]: Die Liste der Gruppen, in denen der Nutzer 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