Class GroupsApp

GroupsApp

Ta klasa zapewnia dostęp do informacji o Grupach dyskusyjnych Google. Może służyć do wysyłania zapytań o informacje, takie jak adres e-mail grupy czy 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 podanym adresie e-mail.
getGroups()Group[]Pobiera wszystkie grupy, których jesteś bezpośrednim członkiem (lub członkiem oczekującym).

Szczegółowa dokumentacja

getGroupByEmail(email)

Pobiera grupę o podanym adresie e-mail. Zgłasza wyjątek, jeśli grupa nie istnieje lub nie masz uprawnień do jej wyświetlania.

Oto przykład, który pobiera grupę na podstawie jej adresu e-mail i określa, 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 do pobrania.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getGroups()

Pobiera wszystkie grupy, których jesteś bezpośrednim członkiem (lub członkiem oczekującym). Jeśli nie należysz do żadnej grupy, ta lista jest pusta. Zgłasza wyjątek, jeśli grupa nie istnieje lub nie masz uprawnień do jej wyświetlania.

Oto przykład drukowania adresu e-mail 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 A, to jesteś pośrednio subskrybentem grupy A. Mimo że otrzymujesz kopie wiadomości wysyłanych do „nadrzędnej” grupy A, nie subskrybujesz tej grupy.

Za pomocą ikony Group.getRole(email) możesz sprawdzić, czy jesteś obecnym czy oczekującym członkiem zwróconych grup.

Powrót

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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