이 페이지에서는 Google Chat API를 사용하여 Google Workspace 조직의 특정 사용자와 Google Chat 스페이스를 공유하여 사용자가 스페이스를 검색하고 참여할 수 있도록 하는 방법을 설명합니다.
조직에서 스페이스를 검색하고 참여할 수 있는 사용자를 지정하려면 공유 대상 그룹을 만듭니다. 공유 대상 그룹 은 스페이스의 인지도와 공유 가능성을 개선하기 위해 Chat 스페이스를 공유할 수 있는 사용자 그룹(예: 특정 부서 또는 전체 조직)입니다. 공유 대상 그룹을 사용하면 스페이스에 개별 사용자를 초대할 필요 없이 스페이스 멤버십을 관리하고 맞춤설정할 수도 있습니다. 자세한 내용은 공유 대상 그룹 정보를 참고하세요.
공유 대상 그룹에 이름이 지정된 스페이스만 검색 가능하게 만들 수 있습니다. 공유 대상 그룹과 채팅 메시지 또는 그룹 대화와 같은 다른 스페이스 유형은 공유할 수 없습니다.
기본 요건
- Google Chat에 액세스할 수 있는 Business 또는 Enterprise Google Workspace 계정 Google Chat 계정에 Google Workspace 조직의 최고 관리자 역할 이 있어야 합니다.
- Chat에서 액세스할 수 있는 공유 대상 그룹 공유 대상 그룹을 만들려면 공유 대상 그룹 만들기를 참고하세요. 기존 공유 대상 그룹을 Chat 스페이스에서 사용할 수 있도록 하려면 Chat에서의 스페이스 액세스 권한 설정을 참고하세요.
- 사용자 인증을 통해 Google Chat API를 호출해야 합니다.
공유 대상 그룹 ID 가져오기
공유 대상 그룹의 ID를 가져오려면 다음 단계를 따르세요.
Google 관리 콘솔에서 메뉴 > 디렉터리 > 공유 대상 그룹으로 이동합니다.
공유 대상 그룹 표에서 공유 대상 그룹의 이름 필드를 클릭합니다.
페이지의 URL에서 공유 대상 그룹 ID를 찾습니다. URL 형식은
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, 여기서TARGET_AUDIENCE_ID는 공유 대상 그룹의 영숫자 ID입니다.
다음 섹션에서는 공유 대상 그룹 ID를 사용하여 검색 가능한 스페이스를 만들거나 기존 스페이스를 업데이트하여 공유 대상 그룹에서 검색 가능하도록 합니다.
Chat API 요청에서 공유 대상 그룹 지정
특정 공유 대상 그룹의 스페이스를 만들려면 create() 또는
setup() 메서드를 Space 리소스에서 사용합니다. 기존 스페이스
를 검색 가능하게 만들려면 update() 메서드를 Space 리소스에서 사용합니다. 이름이 지정된 스페이스만 공유 대상 그룹과 공유할 수 있으므로 스페이스 유형(spaceType 필드에 표시됨)은 SPACE여야 합니다.
공유 대상 그룹에서 스페이스를 검색 가능하게 만들려면 Chat API 요청의 일부로 Space 리소스에
AccessSettings
object를 포함합니다. 객체에서 audience 필드를 지정합니다.
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
TARGET_AUDIENCE_ID를 이전 섹션에서 가져온 공유 대상 그룹의 ID로 바꿉니다. Google Workspace 조직의 기본 Chat 스페이스 공유 설정을 사용하려면 default로 바꿉니다.
Chat API를 사용하여 스페이스를 만들거나 업데이트하는 방법에 대한 자세한 내용은 다음 가이드를 참고하세요.