Google Chat 앱 구성

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

Chat을 확장하는 Google Workspace 부가기능을 배포하고 테스트하려면 Google Chat API를 사용하여 Chat 앱을 사용 설정하고 구성해야 합니다. Chat API 구성 설정은 이름, 아바타, 배포, 사용할 양방향 기능을 비롯하여 Chat 앱에 관한 모든 세부정보를 지정하는 곳입니다.

기본 요건

HTTP

Apps Script

Chat 앱의 표시 이름, 아바타, 설명 선택하기

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

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

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

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

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

Google Cloud 콘솔에서 Chat 앱 구성

Chat 앱 세부정보를 확인한 후 Cloud 프로젝트를 열고 Chat API를 구성합니다.

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

    Chat API 구성 페이지로 이동

  2. 애플리케이션 정보에서 앱 이름, 아바타 URL, 설명 입력란을 작성합니다.

  3. 대화형 기능에서 대화형 기능 사용 설정을 클릭하여 사용 설정 상태로 전환하고 다음을 완료합니다.

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

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

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

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

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

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

      • ADDED_TO_SPACE: 사용자가 그룹 대화 또는 스페이스에 Chat 앱을 추가하거나 1:1 메시지를 위해 Chat 앱을 설치합니다.
      • MESSAGE: 사용자가 Chat 앱에 메시지를 보냅니다. 예를 들어 Chat 앱에 채팅 메시지를 보내거나 여러 사용자가 있는 스페이스에서 Chat 앱을 @멘션합니다.
      • REMOVED_FROM_SPACE: 사용자가 스페이스에서 Chat 앱을 제거합니다.

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

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

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

  5. 저장을 클릭합니다.

구성을 저장하면 Chat API의 표시 설정에서 지정한 모든 사용자가 Chat 앱을 설치, 테스트 또는 사용할 수 있습니다. Chat 앱 테스트 및 디버깅을 시작하려면 Chat API 문서의 Google Chat 앱의 양방향 기능 테스트를 참고하세요.

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

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

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

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

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

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