이 페이지에서는 Google Chat API를 사용하여 Google Workspace 조직의 특정 사용자가 스페이스를 검색하고 참여할 수 있도록 Google Chat 스페이스를 공유하는 방법을 설명합니다.
조직에서 스페이스를 검색하고 참여할 수 있는 사용자를 지정하려면 공유 대상 그룹을 만듭니다. 공유 대상 그룹은 Chat 스페이스의 인지도와 공유 가능성을 개선하기 위해 Chat 스페이스를 공유할 수 있는 사용자 그룹(예: 특정 부서 또는 전체 조직)입니다. 또한 타겟층을 사용하면 개별 사용자를 스페이스에 초대할 필요 없이 스페이스 멤버십을 관리하고 맞춤설정할 수 있습니다. 자세한 내용은 공유 대상 그룹 정보를 참고하세요.
공유 대상 그룹이 이름이 지정된 스페이스만 검색할 수 있도록 설정할 수 있습니다. 다른 스페이스 유형(예: 채팅 메시지 또는 그룹 대화)은 공유 대상 그룹과 공유할 수 없습니다.
기본 요건
- Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정 계정에 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 요청에서 공유 대상 그룹 지정
특정 공유 대상 그룹을 위한 스페이스를 만들려면 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를 사용하여 스페이스를 만들거나 업데이트하는 방법에 관한 자세한 내용은 다음 가이드를 참고하세요.