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가 있는 관리자

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

예를 들어 '조직의 관리자가 Kiran B를 스페이스 관리자로 변경했습니다.'

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

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

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

서비스에서 가장하는 사용자가 작업을 실행한 것으로 식별됩니다.

조직에 Chat API 사용

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

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

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

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

스페이스에 사용자 추가

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

관리자는 spaces.search, 와 함께 사용하여 검색어로 결정된 스페이스 집합에 사용자를 추가할 수 있습니다. 이는 조직에 신규 직원을 온보딩할 때 유용할 수 있으며, 관리자가 일상적인 프로세스를 자동화할 수 있습니다.

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

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

관리자는 spaces.search와 함께 사용하여 사용자가 멤버인 모든 스페이스를 찾은 다음 spaces.members.delete를 사용하여 스페이스에서 사용자를 삭제할 수 있습니다. 이는 직원이 조직 내에서 팀을 이동하거나 더 이상 조직에 속하지 않는 직원을 오프보딩할 때 유용할 수 있으며, 관리자가 일상적인 프로세스를 자동화할 수 있습니다.

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

관리자는 spaces.members.patch를 사용하여 다음 옵션 간에 MembershipRole를 업데이트하여 멤버의 역할을 변경할 수 있습니다.

  • ROLE_MEMBER: 스페이스의 멤버입니다. Chat UI에서 이 역할은 멤버 라고 합니다.
  • ROLE_ASSISTANT_MANAGER: 스페이스 관리자입니다. Chat UI에서 이 역할은 관리자 라고 합니다.
  • ROLE_MANAGER: 스페이스 소유자입니다. Chat UI에서 이 역할은 소유자 라고 합니다.

관리자는 spaces.search와 함께 사용하여 관리자 또는 소유자가 없는 스페이스를 찾은 다음 spaces.members.patch를 사용하여 기존 멤버를 관리자 또는 소유자로 승격할 수 있습니다.

스페이스의 외부 멤버 찾기

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

스페이스 감사 및 관리

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

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

사용되지 않는 Chat 스페이스는 중요한 저장공간을 차지하고 사용자 인터페이스에 혼란을 야기할 수 있습니다. 관리자는 spaces.search 를 사용하여 비활성 스페이스를 찾은 다음 spaces.delete 를 사용하여 삭제할 수 있습니다. 자세한 안내 및 코드 샘플은 비활성 Chat 스페이스 찾기 및 삭제를 참고하세요.

조직의 스페이스 감사

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

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

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

검색 기준에 따라 스페이스 멤버 찾기

spaces.members.list, 관리자는 조직의 모든 스페이스 멤버 목록을 가져오고 특정 기준에 따라 결과를 분석할 수 있습니다.

스페이스 관리자 찾기

관리자는 spaces.members.list를 사용하여 MembershipState=ROLE_MANAGER로 필터링된 스페이스의 멤버 목록을 가져올 수 있습니다.

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