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