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ść | Typ | Opis |
---|---|---|
Role | Role |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getGroupByEmail(email) | Group | Pobiera 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
Nazwa | Typ | Opis |
---|---|---|
email | String | Adres 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