Google Workspace 관리자로 Google Chat 스페이스 관리하기

이 페이지에서는 Google Workspace 관리자가 Google Chat API를 사용하여 조직 전체에서 Google Chat 스페이스를 관리하는 방법을 간략히 설명합니다.

Google Workspace 관리자는 Chat 스페이스를 관리하기 위해 Google 관리 콘솔의 스페이스 관리 도구를 사용하거나 Google Chat API를 호출할 수 있습니다. 관리자는 Chat API를 사용하여 대규모로 스페이스를 관리하고 일반적인 작업 또는 반복 가능한 작업을 자동화하는 Google Chat 앱을 만들 수 있습니다.

관리자가 Chat API로 수행할 수 있는 작업

관리자는 할당된 관리자 역할에 따라 관리 작업을 수행할 수 있습니다.

Google Workspace 관리자는 Chat API를 사용하여 다음과 같은 다양한 관리 작업을 실행할 수 있습니다.

Google Workspace 관리자로 인증하고 승인하는 방법

관리 작업에 Chat API를 사용하는 경우 관리자는 관리자 권한을 호출하거나 애플리케이션의 서비스 계정에 대한 도메인 전체 위임을 구성하여 요청을 인증하고 승인할 수 있습니다.

다음 표에서는 관리자가 Chat API를 사용할 때 인증할 수 있는 방법을 설명합니다.

사용자 인증 API 메서드를 호출하는 사용자 Chat에서 사용자에게 표시되는 항목
관리자 권한 useAdminAccess=true가 있는 관리자

'조직 관리자가 [작업]을 실행했습니다.'

예를 들어 '조직 관리자가 키란 B님을 스페이스 관리자로 변경했습니다.'

관리자 사용자의 이름, 사용자 ID 또는 Chat 앱의 이름을 식별하지 않습니다.
도메인 전체 위임 사용자를 대신하는 서비스 계정

"[사용자] 가 [앱 이름] 을 통해 [작업]을 실행했습니다."

예를 들어 '사샤 T님이 스페이스 이름을 '출시 프로젝트 토론'으로 변경했습니다.'

서비스에서 명의 도용된 사용자가 작업을 실행한 것으로 식별됩니다.

조직에서 Chat API 사용하기

이 섹션의 예에서는 관리자가 관리자 권한으로 조직의 스페이스와 구성원을 관리할 때 Chat API를 사용하는 방법을 보여줍니다.

다음 Chat API 메서드는 useAdminAccess=true를 사용하여 관리자 권한을 사용 설정합니다.

사용자의 스페이스 멤버십 관리

다음 시나리오는 Google Workspace 관리자가 Chat API를 사용하여 조직의 사용자 스페이스 멤버십을 관리하는 방법을 보여줍니다.

스페이스에 사용자 추가

관리자는 spaces.members.create()를 사용하여 조직의 모든 스페이스에 사용자를 추가할 수 있습니다.

spaces.search()와 함께 사용하면 관리자가 검색어에 따라 결정된 스페이스 세트에 사용자를 추가할 수 있습니다. 이는 조직에 신규 직원을 온보딩할 때 유용할 수 있습니다. 관리자가 일상적인 프로세스를 자동화할 수 있기 때문입니다.

스페이스에서 사용자를 찾아 삭제하기

관리자는 spaces.members.get()를 사용하여 사용자가 조직 내 스페이스의 회원인지 (조직 내부 또는 외부) 확인할 수 있습니다.

spaces.search()와 함께 사용하면 관리자가 사용자가 참여 중인 모든 스페이스를 찾은 후 spaces.members.delete()를 사용하여 스페이스에서 삭제할 수 있습니다. 이는 직원이 조직 내에서 팀을 이동하거나 더 이상 조직에 소속되지 않은 직원을 오프보딩할 때 유용할 수 있습니다. 관리자는 이를 통해 일상적인 프로세스를 자동화할 수 있습니다.

사용자를 스페이스 관리자로 승격

관리자는 spaces.members.patch()를 사용하여 스페이스 회원을 ROLE_MEMBER에서 ROLE_MANAGER로 승격할 수 있습니다. 관리자는 spaces.members.patch()를 사용하여 구성원을 ROLE_MANAGER에서 ROLE_MEMBER로 이동할 수도 있습니다.

spaces.search()와 함께 사용하면 관리자는 관리자가 없는 스페이스를 찾은 후 spaces.members.patch()를 사용하여 기존 회원을 ROLE_MANAGER로 승격할 수 있습니다.

스페이스의 외부 회원 찾기

관리자는 spaces.members.list()를 사용하여 스페이스의 구성원 목록을 가져오고, 조직의 People API 또는 Directory API에서 사용자 프로필을 가져온 다음 외부 도메인 또는 조직의 구성원인 사용자의 결과를 필터링할 수 있습니다. 자세한 내용은 채팅에서 사용자를 식별하는 방법을 참고하세요.

스페이스 감사 및 관리

다음 시나리오는 Google Workspace 관리자가 Chat API를 사용하여 조직의 스페이스를 감사하고 관리하는 방법을 보여줍니다.

비활성 스페이스 찾기 및 삭제하기

사용하지 않는 Chat 스페이스는 귀중한 저장공간을 차지하고 사용자 인터페이스를 복잡하게 만들 수 있습니다. 관리자는 spaces.search()를 사용하여 비활성 스페이스를 찾은 다음 spaces.delete()를 사용하여 삭제할 수 있습니다. 자세한 안내와 코드 샘플은 비활성 Chat 스페이스 찾기 및 삭제하기를 참고하세요.

조직의 스페이스 감사

관리자는 spaces.search()를 사용하여 각 스페이스의 설정 및 메타데이터(예: 생성일, 마지막 활동 날짜, 구성원 수, 기록 설정 상태, 외부 게스트 초대 가능 여부)에 관한 자세한 정보가 포함된 조직의 모든 스페이스 목록을 가져올 수 있습니다.

검색 기준에 따라 스페이스 목록 내보내기

관리자는 spaces.search()를 사용하여 query에 지정된 기준을 충족하는 스페이스 목록을 가져오고 분석을 위해 결과를 CSV 파일로 내보낼 수 있습니다.

검색 기준에 따라 스페이스 회원 찾기

관리자는 spaces.members.list()를 사용하여 조직의 모든 스페이스에 대한 구성원 목록을 가져오고 특정 기준에 대한 결과를 분석할 수 있습니다.

스페이스 관리자 찾기

관리자는 spaces.members.list()를 사용하여 MembershipState=ROLE_MANAGER로 필터링된 스페이스의 구성원 목록을 검색할 수 있습니다.

조직의 모든 스페이스에서 모든 스페이스 관리자를 찾으려면 spaces.search()를 사용하여 모두 나열하면 됩니다. 그런 다음 목록의 각 스페이스에 대해 spaces.members.list를 사용하여 관리자를 가져옵니다.