Google Chat 앱 구성

이 페이지에서는 Google Chat 앱을 Google Workspace 부가기능으로 구성하고 배포하는 방법을 설명합니다.

Chat을 확장하는 Google Workspace 부가기능을 배포하고 테스트하려면 Google Chat API를 사용하여 채팅 앱을 사용 설정하고 구성해야 합니다. Chat API 구성 설정에서는 사용하려는 이름, 아바타, 배포, 대화형 기능 등 채팅 앱에 대한 모든 세부정보를 지정합니다.

기본 요건

HTTP

Apps Script

채팅 앱의 표시 이름, 아바타, 설명을 선택합니다.

채팅 앱의 이름, 아바타, 설명은 채팅 UI를 통해 사용자에게 표시됩니다. 채팅 앱과 상호작용하기 위해 사용자는 다음과 같은 방법으로 이 정보를 보거나 사용합니다.

  • 채팅 앱을 @멘션하여 스페이스에 추가하거나 메시지를 보냅니다.
  • 채팅 앱을 찾아 채팅 메시지를 시작합니다. 앱 메뉴에서 채팅 메시지에 채팅 앱의 이름과 아바타가 표시됩니다.
  • 사용자는 작성 창에서 채팅 앱을 탐색하고 이름, 아바타, 설명을 볼 수 있습니다.

채팅 앱을 구성하기 전에 다음 정보를 준비해야 합니다.

필드 설명 형식
앱 이름 채팅 앱의 표시 이름입니다. 최대 25자의 영숫자 문자
아바타 URL 채팅 앱의 아바타로 표시되는 이미지입니다. 정사각형 그래픽 이미지 (PNG 또는 JPEG)를 가리키는 HTTPS URL입니다. 권장 크기는 256x256픽셀 이상입니다.
설명 채팅 앱의 용도에 관한 간단한 설명입니다. 최대 40자의 영숫자 문자

다음 섹션에서는 Chat API의 구성 설정에서 이 정보를 지정합니다.

Google Cloud 콘솔에서 채팅 앱 구성

채팅 앱 세부정보가 있으면 Cloud 프로젝트를 열고 Chat API를 구성합니다.

  1. Google Cloud 콘솔에서 Chat API 페이지로 이동하여 구성 페이지를 클릭합니다.

    Chat API 구성 페이지로 이동

  2. 애플리케이션 정보 아래에서 앱 이름, 아바타 URL, 설명 필드를 작성합니다.

  3. 양방향 기능에서 대화형 기능 사용 설정을 클릭하여 On 위치로 설정하고 다음을 완료합니다.

    1. 기능에서 체크박스를 하나 이상 선택하여 채팅 앱을 설치하고 사용할 수 있도록 합니다.

      • 1:1 메시지 수신: 사용자는 사용자와 채팅 앱 사이의 전용 공간에서 채팅 앱을 설치하고 메시지를 보낼 수 있습니다.

      • 스페이스 및 그룹 대화 참여: 사용자는 여러 사용자와 함께 있는 스페이스에서 Chat 앱을 추가하고 상호작용할 수 있습니다.

    2. 연결 설정에서 Chat의 이벤트 객체를 수신하는 데 사용할 아키텍처를 선택합니다.

      • HTTP 서비스를 사용하려면 HTTP 엔드포인트 URL을 선택하고 URL을 입력합니다.
      • Google Apps Script 프로젝트를 사용하려면 Apps Script를 선택하고 프로젝트의 배포 ID를 제공합니다.

    3. 선택사항: 이벤트 객체를 둘 이상의 엔드포인트 또는 함수로 수신하려면 연결 설정 > 트리거로 이동하여 다음 채팅 트리거에 대한 콜백 함수를 제공하거나 업데이트합니다.

      • 스페이스에 추가됨: 사용자가 채팅 앱을 그룹 대화 또는 스페이스에 추가하거나 1:1 메시지용 Chat 앱을 설치합니다.
      • 메시지: 사용자가 채팅 앱에 메시지를 보냅니다. 예를 들어 채팅 앱에 채팅 메시지를 보내거나 여러 사용자가 있는 스페이스에서 채팅 앱을 @멘션합니다.
      • 스페이스에서 삭제됨: 사용자가 스페이스에서 채팅 앱을 제거하거나 삭제합니다.
      • 앱 명령어: 사용자가 채팅 앱에서 빠른 명령어 또는 슬래시 명령어를 사용합니다.

    4. 선택사항: 빠른 명령어, 슬래시 명령어 또는 링크 미리보기와 같은 다른 대화형 기능을 추가합니다.

    5. Google Workspace Marketplace에 게시하기 전에 채팅 앱을 설치하고 테스트할 수 있도록 공개 상태에서 이메일을 지정합니다. Google Workspace 조직에서 최대 5명의 개인 또는 하나 이상의 Google 그룹스를 지정할 수 있습니다.

  4. 선택사항: 로그에서 Logging에 오류 로깅 체크박스를 선택하여 Google Cloud Logging을 사용합니다. 자세한 내용은 Chat API 문서의 Chat 앱의 오류 로그 쿼리를 참고하세요.

  5. 저장을 클릭합니다.

구성을 저장한 후에는 Chat API의 공개 상태 설정에서 지정한 모든 사용자가 Chat 앱을 설치, 테스트 또는 사용할 수 있습니다. 채팅 앱을 테스트하고 디버깅하려면 Chat API 문서에서 Google Chat 앱의 대화형 기능 테스트를 참고하세요.

기존 Google Workspace 부가기능 관련 고려사항

채팅 앱에는 다른 Google Workspace 애플리케이션을 확장하는 Google Workspace 부가기능과 다른 구성이 필요합니다. 부가기능이 다른 Google Workspace 애플리케이션을 확장하는 경우 채팅 앱 구성을 위한 다음 요구사항을 고려하세요.

  • 개인 및 Google Workspace 관리자 모두 Marketplace에서 부가기능을 설치할 수 있어야 합니다. Google Workspace Marketplace SDK에서 이러한 설치 설정을 구성합니다.
  • 채팅 앱은 매니페스트의 addons.common 객체에서 다른 Google Workspace 애플리케이션용으로 구성한 이름과 로고를 사용하지 않습니다.
  • Google Workspace Marketplace에 게시된 부가기능의 경우 Google Chat API 구성 설정 변경사항의 초안을 저장할 수 없습니다. Chat API 구성 설정을 업데이트하고 저장하면 업데이트된 채팅 앱을 모든 기존 사용자가 사용할 수 있습니다. Marketplace 목록을 업데이트하려면 변경사항을 제출하기 전에 초안을 생성할 수 있습니다.

  • Apps Script를 사용하여 부가기능을 빌드한 경우:

    • 나머지 부가기능 구성에 사용하는 것과 동일한 Apps Script 배포 ID를 사용해야 합니다.
    • Apps Script 편집기를 사용하여 Chat에 테스트 배포를 설치할 수 없습니다. 대신 채팅 UI에서 직접 앱을 설치해야 합니다.

  • HTTP 서비스를 사용하여 부가기능을 빌드한 경우 Google Workspace 부가기능 API를 사용하여 만든 매니페스트 및 배포에서 채팅 앱 구성 세부정보를 생략합니다. Google Workspace Marketplace SDK에 지정한 HTTP 배포는 다른 Google Workspace 애플리케이션에만 사용됩니다.