REST Resource: members

리소스: Member

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가 그룹 멤버십의 주기에 관한 오류를 반환합니다. 예를 들어 group1가 group2의 구성원인 경우 group2는 group1의 구성원이 될 수 없습니다. 회원 역할에 대한 자세한 내용은 회원에게 그룹 역할 할당하기를 참고하세요.

사용 가능한 값:

  • MANAGER: 이 역할은 관리 콘솔을 사용하여 비즈니스용 Google 그룹이 사용 설정된 경우에만 사용할 수 있습니다. 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

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