Class GroupsApp

GroupsApp

Te zajęcia zapewniają dostęp do informacji z Grup dyskusyjnych Google. Może służyć do wysyłania zapytań dotyczących takich informacji jak adres e-mail grupy lub lista grup, których użytkownik jest bezpośrednim członkiem.

Oto przykład ilustrujący, do ilu grup należy bieżący użytkownik:

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

Właściwości

WłaściwośćTypOpis
RoleRole

Metody

MetodaZwracany typKrótki opis
getGroupByEmail(email)GroupPobiera grupę o podanym adresie e-mail.
getGroups()Group[]Pobiera wszystkie grupy, których jesteś bezpośrednim członkiem (lub oczekującym członkiem).

Szczegółowa dokumentacja

getGroupByEmail(email)

Pobiera grupę o podanym adresie e-mail. Jeśli grupa nie istnieje lub nie masz uprawnień, aby ją wyświetlić, tworzy wyjątek.

Oto przykład pobierania grupy na podstawie jej adresu e-mail i informacji o tym, czy obecny użytkownik jest jej członkiem. Przed uruchomieniem zastąp przykładowy adres e-mail prawdziwym adresem e-mail grupy.

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

Parametry

NazwaTypOpis
emailStringAdres e-mail grupy do pobrania.

Powroty

Group – grupa z określonym adresem e-mail.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

getGroups()

Pobiera wszystkie grupy, których jesteś bezpośrednim członkiem (lub oczekującym członkiem). Jeśli nie należysz do żadnej grupy, to jest pusta lista. Jeśli grupa nie istnieje lub nie masz uprawnień, aby ją wyświetlić, tworzy wyjątek.

Oto przykład wydrukowania adresu e-mail każdej grupy, do której należy użytkownik:

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);
}
Zwróć uwagę, że jeśli jesteś członkiem grupy B, która sama jest członkiem innej grupy (A), pośrednio subskrybujesz grupę A. Mimo że otrzymujesz kopie wiadomości wysyłanych do „nadrzędnej” grupy A, nie subskrybujesz tej grupy.

Za pomocą funkcji Group.getRole(email) możesz określić, czy jesteś już członkiem zwróconych grup czy oczekujesz na nie.

Powroty

Group[] – lista grup, których użytkownik jest bezpośrednim członkiem.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

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