Google Workspace 조직의 특정 사용자가 Google Chat 스페이스를 검색할 수 있도록 설정하기

이 페이지에서는 Google Chat API를 사용하여 Google Workspace 조직의 특정 사용자와 Google Chat 스페이스를 공유하여 사용자가 스페이스를 검색하고 참여할 수 있도록 하는 방법을 설명합니다.

스페이스를 검색하고 참여할 수 있는 조직 내 사용자를 지정하려면 공유 대상 그룹을 만듭니다. 공유 대상 그룹은 특정 부서나 전체 조직과 같이 Chat 스페이스를 공유하여 스페이스의 인지도와 공유 가능성을 높일 수 있는 사용자 그룹입니다. 타겟층을 사용하면 스페이스에 개별 사용자를 초대할 필요 없이 스페이스 멤버십을 관리하고 맞춤설정할 수도 있습니다. 자세한 내용은 타겟 고객 정보를 참고하세요.

공유 대상 그룹에만 명명된 스페이스를 검색 가능하게 만들 수 있습니다. 채팅 메시지나 그룹 대화와 같은 다른 스페이스 유형은 공유 대상 그룹과 공유할 수 없습니다.

기본 요건

타겟 잠재고객 ID 가져오기

타겟 잠재고객의 ID를 가져오려면 다음 단계를 따르세요.

  1. Google 관리 콘솔에서 메뉴 > 디렉터리 > 공유 대상 그룹으로 이동합니다.

    공유 대상 그룹으로 이동

  2. 타겟층 표에서 타겟층의 이름 필드를 클릭합니다.

  3. 페이지 URL에서 타겟 잠재고객 ID를 찾습니다. URL 형식은 https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID입니다. 여기서 TARGET_AUDIENCE_ID는 대상 그룹의 영숫자 ID입니다.

다음 섹션에서는 타겟 잠재고객 ID를 사용하여 검색 가능한 스페이스를 만들거나 기존 스페이스를 업데이트하여 타겟 잠재고객이 검색할 수 있도록 합니다.

공유 대상 그룹 및 세부 권한 지정

특정 액세스 권한이 있는 스페이스를 만들려면 Space 리소스에서 create 또는 setup 메서드를 사용합니다. 기존 스페이스의 권한을 업데이트하려면 update 메서드를 사용합니다. 이름이 지정된 스페이스만 공유 대상 그룹과 공유할 수 있으므로 스페이스 유형(spaceType 필드에 표시됨)은 SPACE이어야 합니다.

스페이스를 검색하거나 스페이스에 참여할 수 있는 사용자를 지정하려면 Space 리소스에 AccessSettings 객체를 포함하세요. 객체에서 accessPermissionSettings 필드를 사용하여 다음 권한 중 하나 이상을 지정합니다.

  • 검색 가능: discoverSpaceSetting를 사용하여 스페이스의 이름과 설명을 찾고 Google Chat 내에서 스페이스를 탐색할 수 있는 사용자를 정의합니다. 검색을 위해 여러 공유 대상 그룹을 지정할 수 있습니다.
  • 참여 가능: joinSpaceSetting를 사용하여 명시적인 초대 없이 스페이스에 참여하고 스페이스 메시지를 미리 볼 수 있는 사용자를 정의합니다. 스페이스에 참여할 수 있는 사용자는 스페이스를 검색할 수 있어야 합니다. Google Chat은 이 권한에 대해 단일 타겟 잠재고객을 지원합니다.

다음 예에서는 스페이스를 두 개의 공유 대상 그룹에 검색 가능하도록 설정하고 그중 한 그룹만 참여할 수 있도록 설정하는 방법을 보여줍니다.

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

TARGET_AUDIENCE_ID_1 및 TARGET_AUDIENCE_ID_2을 타겟 잠재고객 ID 가져오기에서 가져온 타겟 잠재고객의 ID로 바꿉니다. Google Workspace 조직에 기본 Chat 스페이스 공유 설정을 사용하려면 default로 대체하세요.

이전 버전과의 호환성을 위해 audience 필드를 사용하세요.

이전 버전과의 호환성을 위해 audience 필드를 사용하여 스페이스에 참여할 수 있는 단일 대상 그룹을 계속 지정할 수 있지만 대상 그룹 및 세부 권한 지정을 대신 사용하는 것이 좋습니다.

audience 필드를 설정하는 것은 joinSpaceSetting 및 discoverSpaceSetting 모두에서 공유 대상 그룹을 지정하는 것과 동일합니다.

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

TARGET_AUDIENCE_ID를 타겟 잠재고객 ID 가져오기에서 가져온 타겟 잠재고객의 ID로 바꿉니다. Google Workspace 조직에 기본 Chat 스페이스 공유 설정을 사용하려면 default로 대체하세요.

API 응답의 액세스 설정 이해하기

스페이스를 가져오면 응답의 AccessSettings 객체에 스페이스에 설정된 세부 권한이 반영됩니다.

AccessSettings의 다음 필드는 스페이스의 검색 가능 여부와 참여 권한을 나타냅니다.

  • accessState: 검색 권한(discoverSpaceSetting)에서 파생됩니다. 하나 이상의 타겟 잠재고객에게 검색이 부여된 경우 이 필드는 DISCOVERABLE입니다. 그렇지 않은 경우 PRIVATE입니다.
  • audience: 참여 권한(joinSpaceSetting)에 매핑됩니다. 단일 타겟 잠재고객에 참여 권한이 부여되면 이 필드에 해당 타겟 잠재고객의 리소스 이름이 포함됩니다.

참여 잠재고객이 없는 검색 가능한 스페이스

스페이스가 공유 대상 그룹에 표시될 수 있지만 직접 참여할 수는 없습니다(예: 사용자가 참여하려면 명시적으로 초대되어야 하는 경우).

이 경우 AccessSettings 객체에는 다음 값이 있습니다.

  • accessState: DISCOVERABLE
  • audience: 생략됨 또는 null

accessState이 DISCOVERABLE로 설정되어 있지만 audience이 없는 경우 스페이스가 discoverSpaceSetting에 지정된 공유 대상 그룹에 의해 검색될 수 있지만 초대된 사용자만 참여할 수 있음을 의미합니다. 스페이스를 검색할 수 있는 타겟 잠재고객을 확인하려면 accessPermissionSettings.discoverSpaceSetting 필드를 확인하세요.

공유 대상 그룹에 대한 자세한 내용은 다음 가이드를 참고하세요.

Chat API를 사용하여 스페이스를 만들거나 업데이트하는 방법에 대한 자세한 내용은 다음 가이드를 참고하세요.