Class GroupsApp

Aplikacja Grupy

Ta klasa zapewnia dostęp do informacji z Google Groups. Może on służyć do uzyskiwania informacji, takich jak adres e-mail grupy lub lista grup, których użytkownik jest bezpośrednim członkiem.

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

const 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 określonym adresie e-mail.
getGroups()Group[]Pobiera wszystkie grupy, których jesteś bezpośrednim członkiem (lub których członkostwo jest oczekujące).

Szczegółowa dokumentacja

getGroupByEmail(email)

Pobiera grupę o określonym adresie e-mail. Wyjątek jest rzucany, jeśli grupa nie istnieje lub nie masz uprawnień do jej wyświetlania.

Oto przykładowy kod, który pobiera grupę według adresu e-mail i wypisuje, czy bieżący użytkownik jest jej członkiem. Przed uruchomieniem zastąp przykładowy adres e-mail adresem e-mail prawdziwej grupy.

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

Parametry

NazwaTypOpis
emailStringAdres e-mail grupy, którą chcesz pobrać.

Powrót

Group – grupa o określonym adresie e-mail.

Autoryzacja

Skrypty, które korzystają 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 których członkostwo jest oczekujące). Jeśli nie należysz do żadnej grupy, lista będzie pusta. Wyjątek jest rzucany, jeśli grupa nie istnieje lub nie masz uprawnień do jej wyświetlania.

Oto przykładowy sposób drukowania adresu e-mail dla każdej grupy, do której należy użytkownik:

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);
}
Pamiętaj, że jeśli należysz do grupy B, która jest członkiem innej grupy, grupy A, to masz pośrednio subskrypcję grupy A. Chociaż otrzymujesz kopie wiadomości wysłanych do „nadrzędnej” grupy A, nie subskrybujesz tej grupy.

Możesz użyć parametru Group.getRole(email), aby sprawdzić, czy jesteś członkiem zwróconych grup (obecnie lub oczekujących).

Powrót

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

Autoryzacja

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

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