Class GroupsApp

그룹스앱

이 클래스는 Google 그룹스 정보에 대한 액세스를 제공합니다. 그룹의 이메일 주소 또는 사용자가 직접 회원으로 있는 그룹 목록과 같은 정보를 쿼리하는 데 사용할 수 있습니다.

다음은 현재 사용자가 구성원인 그룹 수를 보여주는 예입니다.

const groups = GroupsApp.getGroups();
Logger.log(`You belong to ${groups.length} groups.`);

속성

속성	유형	설명
Role	Role

메서드

메서드	반환 유형	간략한 설명
getGroupByEmail(email)	Group	지정된 이메일 주소가 있는 그룹을 검색합니다.
getGroups()	Group[]	내가 직접적인 회원 (또는 대기 중인 회원)인 모든 그룹을 검색합니다.

자세한 문서

getGroupByEmail(email)

지정된 이메일 주소가 있는 그룹을 검색합니다. 그룹이 존재하지 않거나 그룹을 볼 권한이 없는 경우 예외가 발생합니다.

다음은 이메일 주소로 그룹을 가져오고 현재 사용자가 그룹의 구성원인지 여부를 출력하는 예입니다. 실행하기 전에 샘플 이메일 주소를 실제 그룹의 이메일로 바꿉니다.

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

매개변수

이름	유형	설명
email	String	검색할 그룹의 이메일 주소입니다.

리턴

Group: 지정된 이메일 주소가 있는 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

---

getGroups()

내가 직접적인 회원 (또는 대기 중인 회원)인 모든 그룹을 검색합니다. 그룹에 가입하지 않은 경우 이 목록은 비어 있습니다. 그룹이 존재하지 않거나 그룹을 볼 권한이 없는 경우 예외가 발생합니다.

다음은 사용자가 속한 모든 그룹의 이메일 주소를 출력하는 방법의 예입니다.

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

다른 그룹 A의 구성원인 그룹 B의 구성원인 경우 그룹 A를 간접적으로 구독하게 됩니다. '상위' 그룹 A로 전송된 메일의 사본을 수신하더라도 실제로는 해당 그룹을 구독하지 않습니다.

Group.getRole(email)를 사용하여 반환된 그룹의 기존 회원인지 또는 대기 중인 회원인지 확인할 수 있습니다.

리턴

Group[]: 사용자가 직속 회원인 그룹 목록입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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