이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Directory API: 그룹 구성원

그룹에 회원 추가하기
그룹 멤버십 업데이트하기
그룹 구성원 검색
모든 그룹 구성원 검색
그룹에서 멤버십 삭제하기

그룹에 회원 추가하기

그룹에 구성원을 추가하려면 다음 POST 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. 그룹 구성원은 사용자 또는 다른 그룹일 수 있습니다. groupKey는 새 구성원의 그룹 이메일 주소 또는 그룹의 고유한 id입니다. 요청 및 응답 속성은 API 참조를 확인하세요.

POST https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members

그룹을 다른 그룹의 회원으로 추가하는 경우 하위 그룹의 회원이 상위 그룹의 회원으로 표시되기까지 최대 10분이 지연될 수 있습니다. 또한 API는 그룹 멤버십의 주기에 대한 오류를 반환합니다. 예를 들어 group1이 group2의 구성원인 경우 group2는 group1의 구성원이 될 수 없습니다.

JSON 요청

다음 JSON 요청은 그룹 구성원을 만드는 샘플 요청 본문을 보여줍니다. 구성원의 이메일 주소는 liz@example.com이며 그룹에서 구성원의 역할은 MEMBER입니다. POST 요청은 groupKey에 NNNNN을 사용합니다.

POST https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members

{
   "email": "liz@example.com",
    "role": "MEMBER"
}

그룹 구성원의 role는 다음과 같을 수 있습니다.

OWNER: 이 역할은 그룹에 대한 메시지 전송 변경, 회원 추가 또는 삭제, 회원 역할 변경, 그룹 설정 변경, 그룹 삭제 등의 작업을 수행할 수 있습니다. OWNER은(는) 그룹의 구성원이어야 합니다.
MANAGER: 관리 콘솔을 통해 Google Workspace가 사용 설정된 경우에만 이 역할을 사용할 수 있습니다. 관리자 역할은 구성원을 소유자로 만들거나 그룹을 삭제하는 것을 제외하고 소유자 역할로 수행할 수 있는 모든 작업을 수행할 수 있습니다. 그룹에는 OWNER 및 MANAGER 회원이 여러 명 있을 수 있습니다.
MEMBER - 이 역할은 그룹을 구독하고, 토론 자료실을 보고, 그룹의 회원 목록을 볼 수 있습니다. 회원 역할에 대한 자세한 내용은 관리 고객센터를 참고하세요.

JSON 응답

성공하면 HTTP 200 상태 코드와 구성원의 멤버십 정보가 반환됩니다. id는 회원의 고유한 멤버십 ID입니다.

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MEMBER",
   "type": "GROUP"
  }

그룹 구성원의 type는 다음과 같을 수 있습니다.

GROUP - 멤버가 다른 그룹입니다.
MEMBER - 회원이 사용자입니다.

그룹 멤버십 업데이트

그룹 멤버십을 업데이트하려면 다음 PUT 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. groupKey는 그룹의 이메일 주소 또는 그룹의 고유한 id이며 memberKey는 사용자 또는 그룹의 기본 이메일 주소, 사용자의 별칭 이메일 주소 또는 사용자의 고유한 id입니다. 요청 및 응답 속성은 API 참조를 확인하세요.

PUT https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

JSON 요청

다음 JSON 요청은 그룹 멤버십 설정을 업데이트하는 샘플 요청 본문을 보여줍니다. 회원의 이메일 주소가 liz@example.com이며 그룹 내 회원의 역할이 MEMBER에서 MANAGER(으)로 변경됩니다. 이 예에서 PUT 요청의 groupKey는 NNNNN입니다. 회원, 소유자, 관리자 역할에 대한 자세한 내용은 관리 고객센터를 참고하세요.

PUT https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members/liz@example.com

{
   "email": "liz@example.com",
    "role": "MANAGER"
}

JSON 응답

성공 응답이 발생하면 HTTP 200 상태 코드와 업데이트된 멤버십 정보가 반환됩니다. id는 회원의 고유한 멤버십 ID입니다.

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

그룹 구성원 검색

그룹 멤버십을 검색하려면 다음 GET 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. groupKey는 그룹의 이메일 주소 또는 그룹의 고유한 id이며 memberKey는 사용자 또는 그룹의 기본 이메일 주소, 사용자의 별칭 이메일 주소 또는 사용자의 고유한 id입니다. 요청 및 응답 속성은 API 참조를 확인하세요.

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

JSON 응답

성공하면 HTTP 200 상태 코드와 구성원의 멤버십 정보가 반환됩니다. id는 회원의 고유한 멤버십 ID입니다.

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

모든 그룹 구성원 검색

모든 그룹 구성원을 검색하려면 다음 GET 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. groupKey는 그룹의 이메일 주소 또는 그룹의 고유한 id입니다. 선택사항인 roles 쿼리 문자열은 역할별로 그룹 구성원을 검색할 수 있는 필터이며, 결과로 반환되는 역할 컬렉션은 roles 필터에 지정된 순서대로 정렬됩니다. 요청 및 응답 속성은 API 참조를 확인하세요. 이 예시에서는 가독성을 위해 줄 반환을 사용합니다.

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members
?pageToken=pagination token
&roles=one or more of OWNER,MANAGER,MEMBER separated by a comma
&maxResults=maximum results per response page

모든 멤버는 멤버의 알파벳 순으로 반환됩니다. 이메일 주소여야 합니다. 구성원 수가 많은 응답에는 pageToken 쿼리 문자열을 사용합니다. 페이지로 나누기의 경우 응답은 응답 결과의 다음 페이지에 관한 토큰이 포함된 nextPageToken 속성을 반환합니다. 다음 요청에서는 이 토큰을 pageToken 쿼리 문자열 값으로 사용합니다.

JSON 응답

성공 응답은 HTTP 200 상태 코드와 구성원 정보 목록을 반환합니다. id는 회원의 고유한 멤버십 ID입니다. 이 응답의 그룹 회원 후속 목록에 관한 nextPageToken가 있습니다.

{
   "kind": "directory#members",
   "members": [
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "liz@example.com",
    "role": "MANAGER",
    "type": "GROUP"
   },
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "radhe@example.com",
    "role": "MANAGER",
    "type": "MEMBER"
   }
  ],
   "nextPageToken": "NNNNN"
}

그룹에서 멤버십 삭제

그룹에서 회원의 멤버십을 삭제하려면 다음 DELETE 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. groupKey은 그룹의 고유한 id이고 memberKey는 삭제된 사용자 또는 그룹 회원의 기본 이메일 주소 또는 사용자의 고유한 id입니다. 요청 및 응답 속성은 API 참조를 확인하세요.

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

예를 들어 이 DELETE 요청은 groupKey가 nnn이고 memberKey가 사용자의 기본 이메일 주소인 liz@example.com인 구성원을 삭제합니다.

DELETE https://admin.googleapis.com/admin/directory/v1/groups/nnnn/members/liz@example.com

성공 응답은 HTTP 200 상태 코드를 반환합니다.

회원이 삭제된 경우:

삭제된 회원은 더 이상 그룹으로 주소가 지정된 이메일을 수신하지 않습니다.
그룹에서 회원을 삭제해도 사용자의 계정은 삭제되지 않습니다.
그룹 소유자를 삭제해도 그룹은 계속 정상적으로 작동합니다. 관리자는 그룹을 관리하거나 다른 그룹 회원에게 소유권을 할당할 수 있습니다.