REST Resource: spaces.members

리소스: Membership

사용자 또는 채팅 앱이 스페이스에 초대되었는지, 스페이스의 일부인지 또는 부재중인지와 같은 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 사용자 또는 앱입니다. 채팅 앱이 사용자로 인증되면 출력이 사용자 name 및 type에 채워집니다.
groupMember

object (Group)

멤버십에 해당하는 Google 그룹입니다. 읽기 작업만 지원합니다. 멤버십 생성 또는 업데이트와 같은 다른 작업은 현재 지원되지 않습니다.

MembershipState

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

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

MembershipRole

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

열거형
MEMBERSHIP_ROLE_UNSPECIFIED 기본값 users의 경우: 해당 사용자는 스페이스의 멤버가 아니지만 초대할 수 있습니다. Google Groups의 경우 항상 이 역할이 할당됩니다 (나중에 다른 enum 값이 사용될 수도 있음).
ROLE_MEMBER 스페이스의 참여자입니다. 사용자에게 스페이스에 메시지 전송과 같은 기본 권한이 있습니다. 1:1 및 이름이 지정되지 않은 그룹 대화에서 모든 사용자가 이 역할을 맡게 됩니다.
ROLE_MANAGER 스페이스 관리자 사용자에게 모든 기본 권한은 물론 참여자 추가 또는 삭제와 같이 스페이스를 관리할 수 있는 관리 권한도 부여됩니다. SpaceType.SPACE에서만 지원됩니다.

항목 그룹

Google Chat의 Google 그룹

JSON 표현 
{
  "name": string
}
입력란
name

string

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

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

형식: groups/{group}

방법

create

 호출 앱의 인간 멤버십 또는 앱 멤버십을 만듭니다.

delete

 멤버십을 삭제합니다.

get

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

list

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

patch

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