Class GroupsApp

GroupsApp

Questa classe fornisce l'accesso alle informazioni di Google Gruppi. Può essere utilizzato per interrogare informazioni come 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 appartiene l'utente corrente:

const 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 attesa).

Documentazione dettagliata

getGroupByEmail(email)

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

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

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

Parametri

NomeTipoDescrizione
emailStringL'indirizzo email del gruppo da recuperare.

Indietro

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). Se non fai parte di alcun gruppo, questo è un elenco vuoto. 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() {
  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, allora sei abbonato indirettamente al gruppo A. Anche se ricevi copie dei messaggi inviati al gruppo "principale" A, non sei effettivamente iscritto a quel gruppo.

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

Indietro

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