Class GroupsApp

GroupsApp

Esta clase proporciona acceso a la información de Grupos de Google. Se puede usar para consultar información como la dirección de correo electrónico de un grupo o la lista de grupos en los que el usuario es miembro directo.

A continuación, te mostramos un ejemplo de la cantidad de grupos a los que pertenece el usuario actual:

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

Propiedades

PropiedadTipoDescripción
RoleRole

Métodos

MétodoTipo de datos que se muestraDescripción breve
getGroupByEmail(email)GroupRecupera el grupo que tiene la dirección de correo electrónico especificada.
getGroups()Group[]Recupera todos los grupos de los que eres miembro directo (o miembro pendiente).

Documentación detallada

getGroupByEmail(email)

Recupera el grupo que tiene la dirección de correo electrónico especificada. Muestra una excepción si el grupo no existe o si no tienes permiso para verlo.

A continuación, se muestra un ejemplo en el que se obtiene un grupo por su dirección de correo electrónico y se muestra si el usuario actual es miembro. Antes de ejecutarla, reemplaza la dirección de correo electrónico de muestra por el correo electrónico real de un grupo.

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

Parámetros

NombreTipoDescripción
emailStringLa dirección de correo electrónico del grupo que se recuperará.

Devolvedor

Group: Es el grupo con la dirección de correo electrónico especificada.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getGroups()

Recupera todos los grupos de los que eres miembro directo (o miembro pendiente). Esta lista estará vacía si no estás en ningún grupo. Muestra una excepción si el grupo no existe o si no tienes permiso para verlo.

Este es un ejemplo de cómo imprimir la dirección de correo electrónico de cada grupo al que pertenece el usuario:

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);
}
Ten en cuenta que si eres miembro de un grupo B, que a su vez pertenece a otro grupo (A), te suscribes indirectamente al grupo A. Aunque recibas copias de los mensajes enviados al grupo “principal” A, en realidad no estás suscrito a ese grupo.

Puedes usar Group.getRole(email) para determinar si eres un miembro existente o pendiente de los grupos que se muestran.

Devolvedor

Group[]: Es la lista de grupos de los que el usuario es miembro directo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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