REST Resource: spaces.members

리소스: Membership

사용자 또는 Chat 앱이 스페이스에 초대되었는지, 스페이스의 일부인지, 스페이스에 없는지 등 Google Chat의 멤버십 관계를 나타냅니다.

JSON 표현 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,
  "affiliation": enum (Affiliation),

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
필드
name

string

식별자. 서버에서 할당한 멤버십의 리소스 이름입니다.

형식: spaces/{space}/members/{member}
state

enum (MembershipState)

출력 전용입니다. 멤버십의 상태입니다.
role

enum (MembershipRole)

선택사항입니다. Chat 스페이스 내에서 사용자의 역할로, 스페이스에서 허용되는 작업을 결정합니다.

이 필드는 members.patch에서 입력으로만 사용할 수 있습니다.
createTime

string (Timestamp format)

선택사항입니다. 변경할 수 없습니다. 멤버가 스페이스에 참여하거나 스페이스에 참여하도록 초대된 시점과 같은 멤버십 생성 시간입니다. 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
deleteTime

string (Timestamp format)

선택사항입니다. 변경할 수 없습니다. 멤버가 스페이스에서 나가거나 스페이스에서 삭제된 시점과 같은 멤버십 삭제 시간입니다. 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
affiliation

enum (Affiliation)

출력 전용입니다. 스페이스를 소유한 Workspace 조직과의 사용자 관계입니다. 소비자 계정이 소유한 스페이스에서 모든 멤버의 제휴는 EXTERNAL입니다.
통합 필드 memberType. 이 멤버십과 연결된 멤버입니다. 향후 다른 멤버 유형이 지원될 수 있습니다. memberType은 다음 중 하나여야 합니다.
member

object (User)

선택사항입니다. 멤버십에 해당하는 Google Chat 사용자 또는 앱입니다. Chat 앱이 사용자로 사용자로 인증되면 출력에 사용자 name 및 type이 채워집니다.
groupMember

object (Group)

선택사항입니다. 멤버십에 해당하는 Google 그룹입니다.

Google 그룹의 멤버십을 읽거나 변경하려면 사용자 인증이 필요합니다.

MembershipState

멤버와 스페이스의 관계를 지정합니다. 향후 다른 멤버십 상태가 지원될 수 있습니다.

열거형
MEMBERSHIP_STATE_UNSPECIFIED 기본값 사용하지 마세요.
JOINED 사용자가 스페이스에 추가되었으며 스페이스에 참여할 수 있습니다.
INVITED 사용자가 스페이스에 참여하도록 초대되었지만 아직 참여하지 않았습니다.
NOT_A_MEMBER 사용자가 스페이스에 속하지 않으며 스페이스에 참여하기 위한 대기 중인 초대가 없습니다.

MembershipRole

Chat 스페이스에서 허용되는 사용자 작업을 나타냅니다. 향후 더 많은 열거형 값이 추가될 수 있습니다.

열거형
MEMBERSHIP_ROLE_UNSPECIFIED 기본값 users: 스페이스의 멤버는 아니지만 초대될 수 있습니다. Google Groups: 항상 이 역할이 할당됩니다 (향후 다른 열거형 값이 사용될 수 있음).
ROLE_MEMBER

스페이스의 멤버입니다. Chat UI에서 이 역할은 멤버라고 합니다.

사용자에게 스페이스에 메시지 보내기와 같은 기본 권한이 있습니다. 관리자와 소유자는 다음과 같은 스페이스에서 멤버에게 추가 권한을 부여할 수 있습니다.

  • 멤버 추가 또는 삭제
  • 스페이스 세부정보 수정
  • 대화 기록 사용 설정 또는 사용 중지
  • @all을 사용하여 스페이스의 모든 사용자 언급
  • 스페이스에 설치된 Chat 앱 및 웹훅 관리

채팅 메시지 및 이름이 지정되지 않은 그룹 대화에서 모든 사용자에게 이 역할이 있습니다.
ROLE_MANAGER

스페이스 소유자입니다. Chat UI에서 이 역할은 소유자라고 합니다.

사용자에게 다음과 같은 스페이스를 관리할 수 있는 전체 스페이스 권한이 있습니다.

  • 스페이스에서 다른 멤버의 역할을 멤버, 관리자 또는 소유자로 변경
  • 스페이스 삭제

SpaceType.SPACE (이름이 지정된 스페이스)에서만 지원됩니다.

자세한 내용은 스페이스 소유자 또는 관리자 역할 자세히 알아보기
ROLE_ASSISTANT_MANAGER

스페이스 관리자입니다. Chat UI에서 이 역할은 관리자라고 합니다.

사용자에게 ROLE_MEMBER의 모든 기본 권한이 있으며 소유자가 관리 권한의 하위 집합을 부여할 수 있습니다. 기본적으로 관리자는 다음 기능을 제외하고 소유자의 모든 권한을 갖습니다.

  • 스페이스 삭제
  • 다른 스페이스 멤버를 소유자로 지정
  • 소유자의 역할 변경

기본적으로 관리자 권한에는 다음이 포함되지만 이에 국한되지 않습니다.

  • 다른 멤버를 관리자로 지정
  • 스페이스의 메시지 삭제
  • 스페이스 권한 관리
  • 관리자에게 스페이스 설정에서 "멤버 관리" 권한이 있는 경우 스페이스 참여 요청에 대한 알림 수신
  • 스페이스를 검색 가능하게 만들기

SpaceType.SPACE (이름이 지정된 스페이스)에서만 지원됩니다.

자세한 내용은 스페이스 설정 관리

그룹

Google Chat의 Google 그룹입니다.

JSON 표현 
{
  "name": string
}
필드
name

string

Google 그룹의 리소스 이름입니다.

Cloud Identity Groups API의 그룹을 나타냅니다.

형식: groups/{group}

제휴

스페이스를 소유한 Google Workspace 조직과의 사용자 제휴를 나타냅니다. 이 열거형에 향후 더 많은 값이 추가될 수 있습니다.

열거형
AFFILIATION_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
INTERNAL 스페이스를 소유한 동일한 Google Workspace 조직에서 관리하는 계정입니다.
EXTERNAL 스페이스를 소유한 Google Workspace 조직 외부의 계정입니다 (예: 일반 계정 또는 다른 Workspace 조직에서 관리하는 계정).
MANAGED_EXTERNAL 스페이스를 소유한 Workspace 조직에서 관리하지만 조직 외부의 사용자 (예: 게스트 사용자)를 위해 프로비저닝된 계정입니다. 게스트에 대해 자세히 알아보려면 https://support.google.com/chat/answer/16997417을 참고하세요.

메서드

create

 호출 Chat 앱, 사용자 또는 Google 그룹의 멤버십을 만듭니다.

delete

 멤버십을 삭제합니다.

get

 멤버십에 관한 세부정보를 반환합니다.

list

 스페이스의 멤버십을 나열합니다.

patch

 멤버십을 업데이트합니다.