그룹 관리

일반적인 사용 사례를 기반으로 IM은 작업 그룹(Work), 공개 그룹(Public), 회의 그룹(Meeting), 오디오-비디오 그룹(AVChatRoom) 및 커뮤니티 그룹(Community)과 같은 기본 그룹 유형을 제공합니다. 자세한 내용은 그룹 유형를 참고하십시오.
그룹에 다음과 같은 작업을 할 수 있습니다.
그룹 작업
설명
비고
그룹 생성
새로운 그룹을 생성하는 작업. 그룹 이름 및 추가할 사용자 리스트를 지정할 수 있으며, 생성 완료 후 그룹 ID가 반환됩니다. 그룹 ID는 그룹의 유일한 식별자로 이를 통해 메시지 수발신 등 기타 그룹 작업을 할 수 있습니다.
일일 그룹 순 소모 한도: App당 10,000개.
그룹 양도
그룹 소유자를 다른 사람으로 변경하는 작업.
App 관리자의 REST API를 통한 그룹 양도, 그룹 소유자의 그룹 양도만 가능합니다.
그룹 해산
App에 생성한 특정 그룹을 해산하는 작업. 그룹의 기존 구성원은 모두 그룹 해산과 관련된 시스템 메시지를 받습니다.
App 관리자는 REST API를 통해 그룹을 해산할 수 있습니다. App의 그룹 해산 권한은 구성원 역할에 따라 제한됩니다.
공개 그룹(Public), 회의 그룹(Meeting), 오디오-비디오 그룹(AVChatRoom), 커뮤니티(Community): 소유자만 그룹 해산 가능.
업무 그룹(Work): 그룹 해산 불가능.
주의：
그룹 생성 시, IM은 @TGS#로 시작하는 기본 그룹 ID를 할당합니다. 그룹 ID를 수동으로 지정할 수도 있습니다. 자세한 내용은 사용자 정의 그룹 ID를 참고하십시오.
그룹이 생성되면 그룹 생성에 대한 시스템 메시지가 그룹 소유자 디바이스로 전송되어 여러 디바이스 간의 그룹 동기화를 보장합니다(한 디바이스에서 그룹이 생성되면 모든 디바이스에서 생성된 그룹을 즉시 인식합니다).
그룹 프로필 정보 관리
그룹 프로필 정보에는 그룹 이름, 소개, 공지, 그룹 소유자와 같은 단일 그룹 관련 속성과 사용자 정의 그룹 필드가 포함됩니다.
그룹 프로필 정보 관리
설명
비고
그룹 프로필 정보 가져오기
기본 그룹 정보를 풀링합니다. 사용자 정의 정보를 풀링하려면 풀링하려는 사용자 정의 필드에 대한 API를 구성하십시오.
그룹 구성원 그룹 프로필 가져오기: 그룹 구성원은 그룹 프로필을 가져올 수 있습니다.
비구성원 그룹 프로필 가져오기: 구성원이 아닌 사람은 그룹 프로필이 공개된 경우에만 가져올 수 있습니다.
그룹에서 개인 프로필 가져오기: 사용자는 모든 그룹 또는 단일 그룹에서 자신의 프로필을 가져올 수 있습니다. 
그룹 구성원의 프로필 가져오기: 오디오-비디오 그룹(AVChatRoom)은 그룹 구성원 프로필을 저장하지 않으며, 그룹 구성원의 개인 프로필 가져오기를 지원하지 않습니다.
그룹 프로필 정보 수정
그룹 이름, 그룹 소개, 그룹 공지, 그룹 프로필 사진, 그룹 명함, 그룹 참여 옵션, 그룹 차원 사용자 정의 필드, 사용자의 그룹 내 신분, 그룹 구성원 차원 사용자 정의 필드 및 그룹 메시지 수발신 옵션 등 정보를 수정합니다.
현재 App은 콘솔에서 자체적으로 그룹 이름, 소개, 공지, 프로필 사진 URL 변경 콜백을 설정할 수 있습니다. 기타 그룹 자료(그룹 차원의 사용자 정의 필드 포함)의 변경 콜백을 활성화하려는 경우, 티켓 제출을 통해 신청하십시오.
그룹 구성원/그룹 관리
그룹 구성원 관리는 다음 2가지 내용을 포함합니다.
그룹 내 본인 정보를 가져오기/수정합니다. 메시지 수발신 옵션 등 정보는 사용자 본인만 가져오기/설정할 수 있습니다.
그룹 구성원 신분, 그룹 참여 시간, 마지막 메시지 발송 시간, 그룹 명함 및 그룹 구성원 차원의 사용자 정의 정보를 포함한 기타 구성원 정보를 가져오기/수정합니다.
그룹 구성원 관리
설명
비고
그룹 구성원 정보 가져오기
본인 또는 다른 구성원 정보 가져오기.
그룹 구성원 신분, 그룹 참여 시간, 마지막 메시지 발송 시간, 그룹 명함 및 그룹 구성원 차원의 사용자 정의 정보를 가져올 수 있습니다.
그룹 구성원 정보 수정
그룹 소유자, 관리자 또는 구성원 모두 구성원 프로필 정보 수정 가능.
소유자/관리자: 그룹 내 신분(관리자 설정/취소), 음소거, 그룹 명함, 그룹 구성원 차원의 사용자 정의 필드를 포함한 기타 구성원 정보 수정 가능.
그룹 구성원: 메시지 수신 옵션, 그룹 명함, 그룹 구성원 차원의 사용자 정의 필드 등 그룹 내 본인 프로필 정보 수정 가능.
그룹 초대
다른 사용자를 그룹에 초대.
업무 그룹(Work): 모든 구성원은 다른 사람을 그룹에 초대 가능하며 초대 받은 사람이 승인하면 그룹 참여 가능. 
공개 그룹(Public) 및 회의 그룹(Meeting): 기본적으로 App 관리자만 다른 사용자 초대 가능. 
오디오-비디오 그룹(AVChatRoom): 누구나 다른 사람 초대 가능.
커뮤니티(Community)에서 모든 그룹 구성원은 다른 사람을 그룹에 가입하도록 초대할 수 있으며 초대 받은 사람의 동의 없이 직접 그룹에 추가 가능.
그룹 참여 신청
사용자는 IM SDK를 통해 사전에 그룹 가입을 신청
업무 그룹(Work): 그룹 참여 신청 허용하지 않으며 오류 메시지 반환함.
커뮤니티(Community): 신청 승인 없이 그룹에 입장할 수 있습니다.
기타 빌트인 그룹 유형: 그룹 프로필 정보의 ApplyJoinOption 필드에 의해 그룹 참여 신청 결과 결정.
그룹 구성원 삭제
그룹 소유자 또는 관리자가 구성원을 그룹에서 제거하는 작업.
관리자 또는 소유자가 사용자를 그룹에서 삭제하면, 해당 사용자 는 그룹에서 강제 퇴장 관련 시스템 메시지를 받고 다른 구성원들은 해당 사용자가 그룹에서 강제 퇴장 당했다는 이벤트 메시지를 받습니다.
그룹 퇴장
그룹 구성원의 자발적인 그룹 퇴장 작업.
그룹 구성원이 자발적으로 퇴장하면, 퇴장 작업을 요청한 사용자는 자발적 퇴장 관련 시스템 메시지를 받고 다른 구성원들은 해당 구성원이 퇴장했다는 이벤트 메시지를 받습니다.
사용자가 참여한 그룹 가져오기
현재 사용자가 참여한 모든 그룹 리스트 풀링 작업. 반환되는 정보는 일부 기본 정보만 포함됩니다.
자세한 그룹 정보는 그룹 구성원 그룹 프로필 정보 가져오기 기능을 통해 가져올 수 있습니다.
그룹 미결 정보 리스트
승인이 필요한 모든 그룹 작업.
그룹 미결 정보 리스트를 가져오고, 보류 중인 읽음 메시지를 보고하고, 보류 중인 그룹 메시지를 처리(승인 또는 거부)할 수 있습니다. 단일 사용자의 보류 목록은 최대 50개까지 저장됩니다.
﻿

그룹 프로필 정보 관리
그룹 구성원/그룹 관리

그룹 작업	설명	비고
그룹 생성	새로운 그룹을 생성하는 작업. 그룹 이름 및 추가할 사용자 리스트를 지정할 수 있으며, 생성 완료 후 그룹 ID가 반환됩니다. 그룹 ID는 그룹의 유일한 식별자로 이를 통해 메시지 수발신 등 기타 그룹 작업을 할 수 있습니다.	일일 그룹 순 소모 한도: App당 10,000개.
그룹 양도	그룹 소유자를 다른 사람으로 변경하는 작업.	App 관리자의 REST API를 통한 그룹 양도, 그룹 소유자의 그룹 양도만 가능합니다.
그룹 해산	App에 생성한 특정 그룹을 해산하는 작업. 그룹의 기존 구성원은 모두 그룹 해산과 관련된 시스템 메시지를 받습니다.	App 관리자는 REST API를 통해 그룹을 해산할 수 있습니다. App의 그룹 해산 권한은 구성원 역할에 따라 제한됩니다. 공개 그룹(Public), 회의 그룹(Meeting), 오디오-비디오 그룹(AVChatRoom), 커뮤니티(Community): 소유자만 그룹 해산 가능. 업무 그룹(Work): 그룹 해산 불가능.

그룹 구성원 관리	설명	비고
그룹 구성원 정보 가져오기	본인 또는 다른 구성원 정보 가져오기.	그룹 구성원 신분, 그룹 참여 시간, 마지막 메시지 발송 시간, 그룹 명함 및 그룹 구성원 차원의 사용자 정의 정보를 가져올 수 있습니다.
그룹 구성원 정보 수정	그룹 소유자, 관리자 또는 구성원 모두 구성원 프로필 정보 수정 가능.	소유자/관리자: 그룹 내 신분(관리자 설정/취소), 음소거, 그룹 명함, 그룹 구성원 차원의 사용자 정의 필드를 포함한 기타 구성원 정보 수정 가능. 그룹 구성원: 메시지 수신 옵션, 그룹 명함, 그룹 구성원 차원의 사용자 정의 필드 등 그룹 내 본인 프로필 정보 수정 가능.
그룹 초대	다른 사용자를 그룹에 초대.	업무 그룹(Work): 모든 구성원은 다른 사람을 그룹에 초대 가능하며 초대 받은 사람이 승인하면 그룹 참여 가능. 공개 그룹(Public) 및 회의 그룹(Meeting): 기본적으로 App 관리자만 다른 사용자 초대 가능. 오디오-비디오 그룹(AVChatRoom): 누구나 다른 사람 초대 가능. 커뮤니티(Community)에서 모든 그룹 구성원은 다른 사람을 그룹에 가입하도록 초대할 수 있으며 초대 받은 사람의 동의 없이 직접 그룹에 추가 가능.
그룹 참여 신청	사용자는 IM SDK를 통해 사전에 그룹 가입을 신청	업무 그룹(Work): 그룹 참여 신청 허용하지 않으며 오류 메시지 반환함. 커뮤니티(Community): 신청 승인 없이 그룹에 입장할 수 있습니다. 기타 빌트인 그룹 유형: 그룹 프로필 정보의 ApplyJoinOption 필드에 의해 그룹 참여 신청 결과 결정.
그룹 구성원 삭제	그룹 소유자 또는 관리자가 구성원을 그룹에서 제거하는 작업.	관리자 또는 소유자가 사용자를 그룹에서 삭제하면, 해당 사용자 는 그룹에서 강제 퇴장 관련 시스템 메시지를 받고 다른 구성원들은 해당 사용자가 그룹에서 강제 퇴장 당했다는 이벤트 메시지를 받습니다.
그룹 퇴장	그룹 구성원의 자발적인 그룹 퇴장 작업.	그룹 구성원이 자발적으로 퇴장하면, 퇴장 작업을 요청한 사용자는 자발적 퇴장 관련 시스템 메시지를 받고 다른 구성원들은 해당 구성원이 퇴장했다는 이벤트 메시지를 받습니다.
사용자가 참여한 그룹 가져오기	현재 사용자가 참여한 모든 그룹 리스트 풀링 작업. 반환되는 정보는 일부 기본 정보만 포함됩니다.	자세한 그룹 정보는 그룹 구성원 그룹 프로필 정보 가져오기 기능을 통해 가져올 수 있습니다.
그룹 미결 정보 리스트	승인이 필요한 모든 그룹 작업.	그룹 미결 정보 리스트를 가져오고, 보류 중인 읽음 메시지를 보고하고, 보류 중인 그룹 메시지를 처리(승인 또는 거부)할 수 있습니다. 단일 사용자의 보류 목록은 최대 50개까지 저장됩니다.