Class Group

Group

Um objeto de grupo cujos membros e funções deles no grupo podem ser consultados.

Confira um exemplo que mostra os membros de um grupo. Antes de executar, substitua o endereço de e-mail do grupo por um do seu domínio.

function listGroupMembers() {
  const group = GroupsApp.getGroupByEmail('[e-mail]');
  console.log(`${group.getEmail()}:`);
  const users = group.getUsers();
  for (let i = 0; i < users.length; i++) {
    const user = users[i];
    console.log(user.getEmail());
  }
}

Métodos

Método	Tipo de retorno	Breve descrição
getEmail()	String	Recebe o endereço de e-mail deste grupo.
getGroups()	Group[]	Recupera os grupos secundários diretos do grupo.
getRole(email)	Role	Recupera a função de um usuário no contexto do grupo.
getRole(user)	Role	Recupera a função de um usuário no contexto do grupo.
getRoles(users)	Role[]	Recupera as funções dos usuários no contexto do grupo.
getUsers()	User[]	Recebe os membros diretos e banidos do grupo que têm uma conta do Google correspondente conhecida.
hasGroup(group)	Boolean	Testa se um grupo é um membro direto deste grupo.
hasGroup(email)	Boolean	Testa se um grupo é um membro direto deste grupo.
hasUser(email)	Boolean	Testa se um usuário é um membro direto do grupo.
hasUser(user)	Boolean	Testa se um usuário é um membro direto do grupo.

Documentação detalhada

getEmail()

Recebe o endereço de e-mail deste grupo.

Este exemplo lista o endereço de e-mail de todos os grupos a que o usuário pertence.

function listMyGroupEmails() {
  const groups = GroupsApp.getGroups();
  for (let i = 0; i < groups.length; i++) {
    console.log(groups[i].getEmail());
  }
}

Retornar

String: o endereço de e-mail do grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getGroups()

Recupera os grupos secundários diretos do grupo. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo.

Além desse método, você pode usar o serviço avançado Directory do SDK Admin para recuperar membros de um grupo em um domínio.

function listGroupMembers() {
  const GROUP_EMAIL = '[e-mail]';
  const group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  const childGroups = group.getGroups();
  console.log(`Group ${GROUP_EMAIL} has ${childGroups.length} groups:`);
  for (let i = 0; i < childGroups.length; i++) {
    const childGroup = childGroups[i];
    console.log(childGroup.getEmail());
  }
}

Retornar

Group[]: todos os grupos filhos diretos do grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getRole(email)

Recupera a função de um usuário no contexto do grupo. Um usuário que é membro direto de um grupo tem exatamente uma função nele. Gera uma exceção se o usuário não for membro do grupo ou se você não tiver permissão para ver a lista de participantes.

Este exemplo lista os proprietários de um grupo:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  const user = users[i];
  if (group.getRole(user.getEmail()) === GroupsApp.Role.OWNER) {
    console.log(user.getEmail());
  }
}

Parâmetros

Nome	Tipo	Descrição
email	String	É o endereço de e-mail do usuário.

Retornar

Role: o papel do usuário no grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getRole(user)

Recupera a função de um usuário no contexto do grupo. Um usuário que é membro direto de um grupo tem exatamente uma função nele. Gera uma exceção se o usuário não for membro do grupo ou se você não tiver permissão para ver a lista de participantes.

Este exemplo lista os proprietários de um grupo:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  const user = users[i];
  if (group.getRole(user) === GroupsApp.Role.OWNER) {
    console.log(user.getEmail());
  }
}

Parâmetros

Nome	Tipo	Descrição
user	User	O usuário de quem o papel será recuperado.

Retornar

Role: o papel do usuário no grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

Consulte também

• getRole(email)

---

getRoles(users)

Recupera as funções dos usuários no contexto do grupo. Um usuário que é membro direto de um grupo tem exatamente uma função nele. Gera uma exceção se algum usuário não for membro do grupo ou se você não tiver permissão para ver a lista de participantes.

Este exemplo lista os proprietários de um grupo:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const users = group.getUsers();
const roles = group.getRoles(users);
console.log('These are the group owners:');
for (let i = 0; i < users.length; i++) {
  if (roles[i] === GroupsApp.Role.OWNER) {
    console.log(users[i].getEmail());
  }
}

Parâmetros

Nome	Tipo	Descrição
users	User[]	Os usuários cujas funções são solicitadas.

Retornar

Role[]: as funções desses usuários no grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getUsers()

Recebe os membros diretos e banidos do grupo que têm uma conta do Google correspondente conhecida. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo ou os e-mails dos participantes.

Observação: se você for participante de um grupo B que também participa de outro grupo A, sua inscrição no grupo A será indireta. Embora você receba cópias das mensagens enviadas para ele, você não está inscrito no grupo principal A.

Confira um exemplo que mostra os membros de um grupo. Antes de executar, substitua o endereço de e-mail do grupo por um do seu domínio.

function listGroupMembers() {
  const GROUP_EMAIL = '[e-mail]';
  const group = GroupsApp.getGroupByEmail(GROUP_EMAIL);
  const users = group.getUsers();
  console.log(`Group ${GROUP_EMAIL} has ${users.length} members:`);
  for (let i = 0; i < users.length; i++) {
    const user = users[i];
    console.log(user.getEmail());
  }
}

Além desse método, você pode usar o serviço avançado API Directory do SDK Admin para recuperar os participantes de um grupo em um domínio.

Retornar

User[]: todos os participantes diretos do grupo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

hasGroup(group)

Testa se um grupo é um membro direto deste grupo. O método não retorna true se o grupo testado estiver aninhado mais de um nível abaixo desse grupo. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo.

const group = GroupsApp.getGroupByEmail('[e-mail]');
const childGroup = GroupsApp.getGroupByEmail('[e-mail]');
if (group.hasGroup(childGroup)) {
  console.log('[e-mail] is a child group');
}

Parâmetros

Nome	Tipo	Descrição
group	Group	O grupo cuja associação será testada.

Retornar

Boolean: true se esse grupo for um grupo filho deste grupo; false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

hasGroup(email)

Testa se um grupo é um membro direto deste grupo. O método não retorna true se o grupo testado estiver aninhado mais de um nível abaixo desse grupo. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo.

const group = GroupsApp.getGroupByEmail('[e-mail]');
if (group.hasGroup('[e-mail]')) {
  console.log('[e-mail] is a child group');
}

Parâmetros

Nome	Tipo	Descrição
email	String	O endereço de e-mail de um grupo.

Retornar

Boolean: true se esse grupo for um grupo filho deste grupo; false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

hasUser(email)

Testa se um usuário é um membro direto do grupo. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo.

Confira um exemplo que verifica se o usuário atual é membro de um grupo:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser.getEmail())) {
  console.log('You are a member');
}

Parâmetros

Nome	Tipo	Descrição
email	String	É o endereço de e-mail do usuário.

Retornar

Boolean: true se o usuário for participante do grupo; false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

hasUser(user)

Testa se um usuário é um membro direto do grupo. Gera uma exceção se você não tiver permissão para ver a lista de participantes do grupo.

Confira um exemplo que verifica se o usuário atual é membro de um grupo:

const group = GroupsApp.getGroupByEmail('[e-mail]');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  console.log('You are a member');
}

Parâmetros

Nome	Tipo	Descrição
user	User	O usuário cuja assinatura será testada.

Retornar

Boolean: true se o usuário for participante do grupo; false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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