Class GroupsApp

GroupsApp

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

Ecco un esempio che mostra di quanti gruppi fa parte l'utente corrente:

var groups = GroupsApp.getGroups();
Logger.log('You belong to ' + groups.length + ' groups.');

Proprietà

ProprietàTipoDescrizione
RoleRole

Metodi

MetodoTipo restituitoBreve descrizione
getGroupByEmail(email)GroupRecupera 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 lo fa non esiste o se non hai l'autorizzazione per visualizzarli.

Ecco un esempio che recupera un gruppo in base al suo indirizzo email e indica se l'indirizzo utente è un membro. Prima di iniziare, sostituisci l'indirizzo email di esempio con l'indirizzo email di un gruppo reale.

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

Parametri

NomeTipoDescrizione
emailStringL'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 sospeso). Si tratta di un elenco vuoto se non fai parte di alcun gruppo. Genera un'eccezione se il gruppo non esiste o se non hai l'autorizzazione per visualizzarli.

Ecco un esempio di come stampare l'indirizzo email per 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 sei membro di un gruppo B, che a sua volta è membro di un altro gruppo, A, sei iscritto indirettamente al gruppo A. Anche se ricevi copie dei messaggi inviati al "genitore" gruppo A, non sei iscritto a quel gruppo.

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

Invio

Group[]: elenco di gruppi di cui l'utente è un 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