앱 게시

Chat 앱을 만든 후에는 사용자 또는 그룹, 도메인의 모든 사용자, 모든 Google Chat 사용자가 앱을 사용할 수 있도록 게시할 수 있습니다. 사용자는 앱과 함께 채팅 메시지를 시작하거나 아래에 표시된 추천 수신자 목록에서 메시지를 선택하여 스페이스에 추가할 수 있습니다.

사용자는 앱을 이름으로 @멘션하여 제안된 수신자 목록의 범위를 좁힐 수도 있습니다. 예를 들어 '스케줄러 봇'이라는 앱을 게시하고 도메인 유형이 '@sch'인 사용자를 게시하면 Google Chat은 앱을 자동 완성 옵션 중 하나로 제안합니다.

다른 사용자와 앱 공유

다른 사용자가 앱을 사용할 수 있도록 하려면 Google Chat API를 사용 설정하고 구성해야 합니다. Google Chat API 사용 설정을 참고하세요.

대상 잠재고객 및 도메인 설정에 따라 아래 나열된 추가 단계를 수행해야 할 수도 있습니다.

도메인 내에서만 앱 공유

관리자가 신뢰할 수 있는 앱을 수동으로 추가하지 않는 한, 앱 구성을 저장할 때 Chat API에서 지정한 사용자에게 앱이 제공됩니다.

관리자가 신뢰할 수 있는 앱을 수동으로 추가해야 하는 경우 다음 단계를 따르세요.

  1. Google Workspace Marketplace SDK를 사용하여 도메인에 앱을 비공개로 게시하는 단계를 따릅니다. Google Workspace Marketplace SDK로 앱 게시를 참고하세요.
  2. 관리자가 앱을 도메인의 허용 목록에 추가하도록 합니다.

앱 공개

Chat API를 구성한 후 단계에 따라 Google Workspace Marketplace SDK를 사용하여 공개적으로 게시합니다. Google Workspace Marketplace SDK로 앱 게시를 참고하세요.

Google Chat API 사용 설정

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

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

앱 구성을 저장하면 도메인의 지정된 사용자가 앱을 사용할 수 있습니다.

앱 구성 정보

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

앱 사용 중지

구성 페이지를 저장하면 앱 상태 필드가 나타납니다. 이 필드를 사용하면 앱을 실시간 또는 사용 안함으로 설정할 수 있습니다.

Chat 앱을 사용 중지하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔을 엽니다. 
  2. 필요한 경우 Chat 앱을 호스팅하는 Google Cloud 프로젝트를 선택합니다.
    1. 'Google Cloud' 옆의 아래쪽 화살표 를 클릭합니다. 현재 프로젝트를 나열하는 대화상자가 나타납니다.
    2. 이전된 Chat 앱을 호스팅하는 프로젝트를 선택합니다.
    3. 열기를 클릭합니다.
  3. 'Google Chat API'를 검색하고 Chat API를 클릭합니다.
  4. 관리를 클릭합니다.
  5. 구성을 클릭합니다.
  6. '앱 상태' 섹션에서 사용 중지됨을 선택합니다.
  7. 저장을 클릭합니다.

앱 구성 권한 부여

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

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

Google Workspace Marketplace SDK로 앱 게시

Google Workspace Marketplace SDK를 사용하여 다음을 수행합니다.

  • 앱을 공개적으로 게시하고 모든 Google Chat 사용자가 스페이스에 Chat 앱을 추가하도록 허용합니다.
  • 도메인에 앱을 게시합니다.

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

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

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