REST Resource: members

리소스: 구성원

Google 그룹스 구성원은 사용자 또는 다른 그룹일 수 있습니다. 이 구성원은 계정 도메인 내부 또는 외부에 있을 수 있습니다. 일반적인 그룹 구성원 작업에 관한 자세한 내용은 개발자 가이드를 참고하세요.

JSON 표현
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
필드
kind

string

API 리소스의 유형입니다. 회원 리소스의 값은 admin#directory#member입니다.

email

string

회원의 이메일 주소입니다. 구성원은 사용자 또는 다른 그룹일 수 있습니다. 이 속성은 그룹에 구성원을 추가할 때 필요합니다. email은(는) 고유해야 하며 다른 그룹의 별칭이 될 수 없습니다. 이메일 주소가 변경되면 API에 이메일 주소 변경사항이 자동으로 반영됩니다.

role

string

그룹에서 회원의 역할입니다. API가 그룹 멤버십의 주기에 대한 오류를 반환합니다. 예를 들어 group1group2의 멤버이면 group2group1의 멤버가 될 수 없습니다. 회원의 역할에 대한 자세한 내용은 회원에게 그룹 역할 할당하기를 참고하세요.

사용 가능한 값:

  • MANAGER: 이 역할은 관리 콘솔에서 Google Groups for Business를 사용 설정한 경우에만 사용할 수 있습니다. Groups for Business 사용 또는 사용 중지를 참조하세요. MANAGER 역할은 OWNER 역할로 회원을 OWNER로 만들거나 그룹을 삭제하는 작업을 제외한 모든 작업을 수행할 수 있습니다. 그룹에는 여러 명의 MANAGER 회원이 있을 수 있습니다.
  • MEMBER: 이 역할은 그룹을 구독하고 토론 자료실을 보고 그룹의 회원 목록을 볼 수 있습니다. 회원 역할에 대한 자세한 내용은 회원에게 그룹 역할 할당하기를 참고하세요.
  • OWNER: 이 역할은 그룹에 메시지 전송, 회원 추가 또는 삭제, 회원 역할 변경, 그룹 설정 변경, 그룹 삭제 등의 작업을 수행할 수 있습니다. OWNER는 그룹의 구성원이어야 합니다. 그룹에는 OWNER가 두 개 이상 있을 수 있습니다.
etag

string

리소스의 ETag입니다.

type

string

그룹 구성원의 유형입니다.

사용 가능한 값:

  • CUSTOMER: 구성원이 도메인의 모든 사용자를 나타냅니다. 이메일 주소는 반환되지 않으며 반환된 ID는 고객 ID입니다.
  • EXTERNAL: 구성원이 도메인 외부의 사용자 또는 그룹입니다. (현재 사용되지 않음)
  • GROUP: 구성원이 다른 그룹입니다.
  • USER: 구성원이 사용자입니다.
status

string

구성원의 상태 (변경할 수 없음)

delivery_settings

string

구성원의 메일 전송 환경설정을 정의합니다. 이 필드는 insert, update, get 메서드에서만 지원됩니다.

사용 가능한 값:

  • ALL_MAIL: 모든 메시지가 도착하는 즉시 전송됩니다.
  • DAILY: 하루에 1회까지만 메시지를 전송합니다.
  • DIGEST: 최대 25개의 메시지를 단일 메시지로 묶습니다.
  • DISABLED: 구독을 삭제합니다.
  • NONE: 메시지가 없습니다.
id

string

그룹 구성원의 고유 ID입니다. 멤버 id는 멤버 요청 URI의 memberKey로 사용할 수 있습니다.

방법

delete

그룹에서 회원을 삭제합니다.

get

그룹 구성원의 속성을 검색합니다.

hasMember

지정된 사용자가 그룹의 구성원인지 확인합니다.

insert

지정된 그룹에 사용자를 추가합니다.

list

그룹에 있는 모든 구성원의 페이지로 나눈 목록을 검색합니다.

patch

지정된 그룹에 있는 사용자의 멤버십 속성을 업데이트합니다.

update

지정된 그룹에 있는 사용자의 멤버십을 업데이트합니다.