REST Resource: spaces.members

리소스: Membership

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

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

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
필드
name

string

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

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

enum (MembershipState)

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

enum (MembershipRole)

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

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

string (Timestamp format)

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

string (Timestamp format)

선택사항입니다. 변경할 수 없습니다. 멤버가 스페이스를 탈퇴하거나 스페이스에서 삭제된 경우와 같은 멤버십 삭제 시간입니다. 이 필드는 가져오기 모드 스페이스에서 이전 멤버십을 가져오는 데 사용되는 경우를 제외하고 출력 전용입니다.
통합 필드 memberType. 이 멤버십과 연결된 회원입니다. 향후 다른 회원 유형이 지원될 수 있습니다. memberType은 다음 중 하나여야 합니다.
member

object (User)

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

object (Group)

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

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

MembershipState

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

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

MembershipRole

Chat 스페이스에서 허용된 사용자의 작업을 나타냅니다. 향후 더 많은 enum 값이 추가될 수 있습니다.

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

스페이스의 구성원입니다. Chat UI에서 이 역할은 회원이라고 합니다.

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

  • 회원을 추가하거나 삭제합니다.
  • 스페이스 세부정보를 수정합니다.
  • 기록을 사용 설정 또는 사용 중지합니다.
  • @all를 사용하여 스페이스의 모든 사용자를 멘션합니다.
  • 스페이스에 설치된 Chat 앱 및 웹훅을 관리합니다.

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

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

사용자에게는 다음을 포함하여 스페이스를 관리할 수 있는 전체 스페이스 권한이 있습니다.

  • 스페이스의 다른 멤버 역할을 회원, 관리자 또는 소유자로 변경합니다.
  • 스페이스를 삭제합니다.

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

자세한 내용은 스페이스 소유자 또는 관리자 역할 자세히 알아보기를 참고하세요.
ROLE_ASSISTANT_MANAGER

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

사용자는 ROLE_MEMBER의 모든 기본 권한을 보유하며 소유자가 관리 권한의 일부를 부여할 수 있습니다. 기본적으로 관리자는 다음 기능을 제외하고 소유자와 동일한 권한을 갖습니다.

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

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

  • 다른 회원을 관리자로 지정
  • 스페이스에서 메시지를 삭제합니다.
  • 스페이스 권한 관리
  • 관리자가 스페이스 설정에서 '멤버 관리' 권한을 보유한 경우 스페이스 참여 요청에 대한 알림을 받습니다.
  • 스페이스를 검색 가능하게 설정합니다.

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

자세한 내용은 스페이스 설정 관리를 참고하세요.

그룹

Google Chat의 Google 그룹.

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

string

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

Cloud ID 그룹스 API의 그룹을 나타냅니다.

형식: groups/{group}

메서드

create

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

delete

 멤버십을 삭제합니다.

get

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

list

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

patch

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