Class GroupsApp

GroupsApp

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

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

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

속성

속성	유형	설명
Role	Role

방법

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

자세한 문서

getGroupByEmail(email)

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

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

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

매개변수

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

리턴

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

---

getGroups()

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

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

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

자신이 다른 그룹 A의 구성원인 그룹 B의 구성원인 경우 그룹 A에 간접적으로 가입된 것입니다. '상위' 그룹 A에 전송된 메시지의 사본을 수신하더라도 실제로 해당 그룹을 구독하고 있는 것은 아닙니다.

Group.getRole(email)를 사용하여 자신이 반환된 그룹의 기존 구성원인지 대기 중인 구성원인지 확인할 수 있습니다.

리턴

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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