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