Class GroupsApp

GroupsApp

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

Ecco un esempio che mostra a quanti gruppi è membro l'utente corrente:

var 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 sospeso).

Documentazione dettagliata

getGroupByEmail(email)

Recupera il gruppo con l'indirizzo email specificato. Genera un'eccezione se il gruppo non esiste o se non si dispone delle autorizzazioni per visualizzarlo.

Ecco un esempio che recupera un gruppo in base all'indirizzo email e indica se l'utente corrente è membro. Prima dell'esecuzione, sostituisci l'indirizzo email di esempio con quello di un gruppo reale.

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

Parametri

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

Ritorni

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 sospeso). Questo è un elenco vuoto se non fai parte di alcun gruppo. Genera 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() {
  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);
}

Tieni presente che se fai parte di un gruppo B, che a sua volta è membro di un altro gruppo, A, sei indirettamente iscritto al gruppo A. Anche se ricevi copie dei messaggi inviati al gruppo "padre" A, non sei iscritto a quel gruppo.

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

Ritorni

Group[]: l'elenco di 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