Google Chat 앱 게시하기

채팅 앱을 만든 후에는 특정 사용자나 그룹, Google Workspace 조직의 모든 사용자, 모든 Google Chat 사용자가 사용하도록 앱을 게시할 수 있습니다.

사용자가 Chat 앱을 검색하고 사용하는 방법

Google Chat 앱을 찾으려면 사용자는 다음 중 하나를 수행하면 됩니다.

  • Google Chat 또는 Google Workspace Marketplace에서 Chat 앱을 검색하고 설치합니다.
  • Chat 스페이스에 추가된 앱과 상호작용합니다.
  • Google Workspace 관리자가 사용자 대신 앱을 설치한 후 채팅 메시지 패널에서 앱을 찾습니다.

Google Chat 사용자는 앱과의 채팅 메시지를 시작하거나 스페이스에 추가하여 앱을 사용할 수 있습니다. 사용자는 @ 멘션하여 앱을 추가할 수도 있습니다. 다음 예는 사용자 @ 이 채팅 앱을 멘션하여 스페이스에 추가하는 방법을 보여줍니다.

메시지에 @ 기호를 입력하여 스페이스에 앱을 추가합니다.

Google Workspace 관리자가 Chat 앱을 설치하는 방법

Google Workspace 관리자는 Google Workspace Marketplace에서 Chat 앱을 찾고 조직의 사용자를 위해 앱을 설치할 수 있습니다. 관리자가 채팅 앱을 설치하면 앱이 사용자의 채팅 메시지 패널에 표시됩니다.

Google Workspace 관리자는 Google Workspace 조직에서 Chat 앱 사용을 관리하고 허용 목록에 추가할 수도 있습니다. 허용 목록을 사용하는 조직의 Chat 앱을 개발하는 경우 사용자가 앱을 찾고 사용할 수 있도록 관리자에게 채팅 앱을 허용 목록에 추가하도록 요청해야 합니다. 자세한 내용은 Google Workspace 관리자 도움말의 문서 사용자가 Chat 앱을 설치하도록 허용을 참조하세요.

Google Cloud 콘솔을 사용하여 채팅 앱 구성 및 게시

채팅 앱을 게시하고 다른 사용자가 사용할 수 있도록 하려면 일반적으로 다음 단계를 따라야 합니다.

  1. Google Chat API를 사용 설정 및 구성합니다. API를 구성할 때 다른 Google Chat 사용자에게 테스트를 위해 Chat 앱에 액세스할 수 있는 권한을 부여합니다.
  2. Google Workspace Marketplace SDK를 사용하여 앱을 게시합니다. Google Workspace 조직의 사용자 또는 모든 Google Chat 사용자가 사용할 수 있도록 채팅 앱을 구성할 수 있습니다.
  3. Google Workspace 조직에서 Chat 앱에 대한 액세스를 관리하는 경우 Google Workspace 관리자에게 조직의 허용 목록에 앱을 추가하도록 요청하세요.

채팅 앱의 공개 상태 및 게시 설정

다음 표에서는 채팅 앱의 잠재고객에 따라 Google Chat API 및 Google Workspace Marketplace SDK의 설정을 구성하는 방법을 설명합니다.

의도한 앱 사용자 인증 방법 Google Chat API 설정 Google Workspace Marketplace SDK 설정 채팅 앱은 어디에 게시되나요?
소규모 팀 사용자 또는 으로 인증합니다. 공개 상태 설정에서 앱에 액세스할 수 있는 사용자 또는 Google 그룹을 지정합니다.

Google Workspace 계정에서 앱을 허용 목록에 추가해야 하는 경우 개별 이메일 주소를 5개까지만 지정할 수 있습니다 (Google 그룹스는 지정할 수 없음).

채팅 앱용 Google Workspace Marketplace SDK를 구성할 필요는 없습니다. 팀 구성원은 Google Chat에서 채팅 앱을 찾아 사용할 수 있습니다.
대규모 팀 사용자 또는 으로 인증합니다. 공개 상태 설정에서 채팅 앱을 테스트할 사용자 또는 Google 그룹을 지정합니다.

테스트 후 Google Workspace Marketplace SDK의 설정을 사용하여 Google Workspace 조직에 채팅 앱을 게시하세요.

앱 공개 상태비공개로 설정합니다.

설치 설정개인 + 관리자로 설정합니다.

Google Workspace 계정에서 앱을 허용 목록에 추가해야 하는 경우 사용자가 앱을 찾고 사용할 수 있도록 관리자에게 채팅 앱을 허용 목록에 추가하도록 요청하세요. 자세한 내용은 Google Workspace 관리자 도움말의 문서 사용자가 Chat 앱을 설치하도록 허용을 참조하세요.

Google Workspace 조직의 모든 사용자가 Google Chat에서 채팅 앱을 찾아 설치하고 Google Workspace Marketplace에서 앱을 볼 수 있습니다. 사용자 및 Google Workspace 관리자는 Marketplace에서 앱을 설치할 수 있습니다.

Google Workspace 조직 사용자 또는 으로 인증합니다. 공개 상태 설정에서 채팅 앱을 테스트할 사용자 또는 Google 그룹을 지정합니다.

테스트 후 Google Workspace Marketplace SDK의 설정을 사용하여 Google Workspace 조직에 채팅 앱을 게시하세요.

앱 공개 상태비공개로 설정합니다.

설치 설정개인 + 관리자로 설정합니다.

Google Workspace 조직의 모든 사용자가 Google Chat에서 채팅 앱을 찾아 설치하고 Google Workspace Marketplace에서 앱을 볼 수 있습니다. Google Workspace 관리자만 Marketplace에서 앱을 설치할 수 있습니다.

모든 사용자 (공개 채팅 앱) 사용자 또는 으로 인증합니다. 공개 상태 설정에서 채팅 앱을 테스트할 사용자 또는 Google 그룹을 지정합니다.

테스트 후 Google Workspace Marketplace의 설정을 사용하여 채팅 앱을 공개적으로 게시하세요.

앱 공개 상태공개로 설정합니다.

설치 설정개인 + 관리자로 설정합니다.

모든 Google Workspace 사용자는 Google Chat에서 채팅 앱을 찾아 설치할 수 있으며 Google Workspace Marketplace에서 앱을 볼 수 있습니다. Google Workspace 관리자만 Marketplace에서 앱을 설치할 수 있습니다.

Google Chat API 사용 설정 및 구성

Google Cloud 콘솔에서 앱의 프로젝트를 설정하고 Google Chat API를 사용 설정합니다.

  1. 아래 버튼을 사용하여 새 프로젝트를 만들거나 기존 프로젝트를 선택하고 서비스 계정을 추가합니다. 서비스 계정에 프로젝트 소유자 역할을 부여합니다.
    API 사용 설정
  2. 다운로드한 JSON 키를 저장합니다. 앱은 이 키를 사용하여 비동기적으로 스페이스로 보내는 메시지를 인증할 수 있습니다.
  3. 에서 프로젝트를 엽니다. API 목록에서 Google Chat API를 클릭합니다.
  4. 구성 탭을 선택하고 다음 표에 설명된 대로 앱 정보를 입력합니다.

앱 구성을 저장하면 Google Workspace 조직의 지정된 사용자가 앱을 사용할 수 있게 됩니다.

Google Chat API 구성 설정

필드 설명
앱 이름 사용자가 채팅 앱과 상호작용할 때 사용하는 이름입니다.
아바타 URL 채팅 앱의 아바타로 표시될 128x128 이상의 정사각형 그래픽 이미지 (예: PNG 또는 JPEG)를 가리키는 HTTPS URL입니다.
설명 채팅 앱 이름 아래에 표시되는 채팅 앱 기능에 관한 설명입니다.
기능 채팅 앱이 사용자와 상호작용하는 방법을 결정하는 필드 모음:
  • 1:1 메시지 수신: 사용자가 Google Chat에서 직접 채팅 앱을 찾아 메시지를 보낼 수 있습니다.
  • 스페이스 및 그룹 대화 참여: 사용자는 스페이스 및 그룹 대화에 Chat 앱을 추가할 수 있습니다.
연결 설정 채팅 앱의 엔드포인트로, 다음 중 하나입니다.
  • 앱 URL: 채팅 앱 구현을 호스팅하는 HTTPS 엔드포인트입니다.
  • Apps Script 프로젝트: 채팅 앱을 구현하는 Apps Script 프로젝트의 배포 ID입니다.
  • Cloud Pub/Sub 주제 이름: 채팅 앱이 엔드포인트로 구독하는 Cloud Pub/Sub 주제입니다.
  • Dialogflow: Dialogflow 통합으로 채팅 앱을 등록합니다. 자세한 내용은 Google Chat과의 통합에 대한 Dialogflow 문서를 참조하세요.
슬래시 명령어 Google Chat 내에서 사용자에게 표시될 수 있는 명령어입니다. 사용자가 Google Chat 내에서 채팅 앱의 핵심 작업을 확인하고 상호작용하려는 특정 작업을 선택할 수 있도록 허용합니다.
링크 미리보기 사용자가 링크를 보낼 때 채팅 앱이 인식하고 추가 콘텐츠를 제공하는 URL 패턴입니다. 자세한 내용은 미리보기 링크를 참고하세요.
공개 상태 채팅 앱을 보고 설치할 수 있는 최대 5명의 개인 또는 하나 이상의 Google 그룹스입니다. 이 필드를 사용하여 채팅 앱을 테스트하거나 채팅 앱을 팀과 공유하세요. 자세한 내용은 채팅 앱의 공개 상태 및 게시 설정을 참고하세요.

앱 구성 권한 부여

특정 사용자에게 앱 구성 페이지에 대한 액세스 권한을 부여할 수 있습니다. 이렇게 하려면 채팅 앱 소유자채팅 앱 뷰어 IAM 역할을 사용합니다. 이러한 역할이 있는 사용자는 API 및 서비스 대시보드를 통해 앱 구성 페이지로 이동할 수 없지만 다음과 같이 프로젝트의 콘솔로 이동하여 구성 페이지에 액세스할 수 있습니다.

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Google Workspace Marketplace SDK로 앱 게시

Google Workspace Marketplace SDK를 사용하여 다음 중 하나를 수행할 수 있습니다.

  • 채팅 앱을 공개적으로 게시하고 모든 Google Chat 사용자가 앱을 스페이스에 추가하도록 허용합니다.
  • 채팅 앱을 Google Workspace 조직에 게시합니다.
  • Google Workspace 관리자가 조직의 사용자를 위해 앱을 설치할 수 있도록 앱을 공개합니다. Google Workspace 관리자에게 표시되려면 앱에 채팅 메시지 기능이 있어야 합니다.

Google Workspace Marketplace SDK를 사용하여 앱을 게시하기 전에 다음 단계를 따르세요.

  1. Chat에서 설치하여 채팅 앱을 테스트합니다. 앱이 제대로 작동하며 진행 중인 작업이 아닌지 확인합니다.
  2. 게시 요구사항을 검토하고 앱이 모든 요건을 충족하는지 확인합니다. 검토 영역을 참고하세요.
  3. 앱의 버전 번호를 기록합니다. Google Workspace Marketplace SDK를 구성하는 데 필요합니다.

게시할 준비가 되면 개요: 앱 게시를 참고하세요.