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

리소스의 eETag입니다.

type

string

그룹 회원의 유형입니다.

사용 가능한 값:

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

string

구성원 상태 (변경 불가능)

delivery_settings

string

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

사용 가능한 값:

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

string

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

메서드

delete

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

get

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

hasMember

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

insert

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

list

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

patch

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

update

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