Class GroupsApp

App Gruppi

Questo corso fornisce l'accesso alle informazioni di Google Gruppi. Può essere utilizzato per eseguire query su informazioni come l'indirizzo email di un gruppo o l'elenco dei gruppi di cui l'utente è membro diretto.

Ecco un esempio che mostra quanti gruppi fanno parte dell'utente corrente:

const groups = GroupsApp.getGroups();
Logger.log(`You belong to ${groups.length} groups.`);

Proprietà

Proprietà	Tipo	Descrizione
Role	Role

Metodi

Metodo	Tipo restituito	Breve descrizione
getGroupByEmail(email)	Group	Recupera il gruppo con l'indirizzo email specificato.
getGroups()	Group[]	Recupera tutti i gruppi di cui sei membro diretto (o membro in attesa).

Documentazione dettagliata

getGroupByEmail(email)

Recupera il gruppo con l'indirizzo email specificato. Viene lanciata un'eccezione se il gruppo non esiste o se non disponi dell'autorizzazione per visualizzarlo.

Di seguito è riportato un esempio che recupera un gruppo tramite il relativo indirizzo email e indica se l'utente corrente è un membro. Prima di eseguire il report, sostituisci l'indirizzo email di esempio con l'indirizzo email di un gruppo reale.

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

Parametri

Nome	Tipo	Descrizione
email	String	L'indirizzo email del gruppo da recuperare.

Invio

Group: il gruppo con l'indirizzo email specificato.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getGroups()

Recupera tutti i gruppi di cui sei membro diretto (o membro in attesa). Si tratta di un elenco vuoto se non fai parte di nessun gruppo. Viene lanciata un'eccezione se il gruppo non esiste o se non disponi dell'autorizzazione per visualizzarlo.

Ecco un esempio di come stampare l'indirizzo email di ogni gruppo a cui appartiene l'utente:

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

Tieni presente che se fai parte di un gruppo B, che è a sua volta membro di un altro gruppo A, hai indirettamente effettuato l'iscrizione al gruppo A. Anche se ricevi copie dei messaggi inviati al gruppo "principale" A, non hai effettivamente effettuato l'iscrizione a quel gruppo.

Puoi utilizzare Group.getRole(email) per determinare se sei un membro esistente o in attesa dei gruppi restituiti.

Invio

Group[]: l'elenco dei gruppi di cui l'utente è membro diretto.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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