이 페이지는 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를 사용 설정한 경우에만 사용할 수 있습니다. 관리자 역할은 회원을 소유자로 만들거나 그룹을 삭제하는 작업을 제외하고 소유자 역할에서 수행하는 모든 작업을 할 수 있습니다. 그룹에는 여러 명의 소유자와 관리자 회원이 있을 수 있습니다.
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 상태 코드를 반환합니다.

회원이 삭제되는 경우:

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