Google Apps Script로 Google Chat 앱 빌드하기

직접 메시지를 보내고 메시지를 에코하여 응답하는 Google Chat 앱을 만듭니다.

다음 다이어그램은 아키텍처 및 메시지 패턴을 보여줍니다.

Apps Script로 구현된 채팅 앱의 아키텍처

위 다이어그램에서 Apps Script Chat 앱과 상호작용하는 사용자는 다음과 같은 정보 흐름을 가지고 있습니다.

  1. 사용자가 채팅 메시지 또는 Chat 스페이스를 통해 채팅 앱에 메시지를 보냅니다.
  2. Google Cloud에 있는 Apps Script에 구현된 채팅 앱 로직이 메시지를 수신하고 처리합니다.
  3. 원하는 경우 채팅 앱 로직을 Calendar나 Sheets와 같은 Google Workspace 서비스나 다른 Google 서비스(예: Google 지도 또는 YouTube)와 통합할 수 있습니다.
  4. 채팅 앱 로직은 Chat의 채팅 앱 서비스로 응답을 다시 보냅니다.
  5. 응답이 사용자에게 전달됩니다.

목표

  • 환경을 설정합니다.
  • 스크립트를 설정합니다.
  • 채팅 앱을 게시합니다.
  • 채팅 앱을 테스트합니다.

기본 요건

환경 설정

Google Cloud 콘솔에서 Cloud 프로젝트를 엽니다.

이 샘플에 사용할 Cloud 프로젝트가 아직 열려 있지 않다면 엽니다.

  1. Google Cloud 콘솔에서 프로젝트 선택 페이지로 이동합니다.

    Cloud 프로젝트 선택

  2. 사용할 Google Cloud 프로젝트를 선택합니다. 또는 프로젝트 만들기를 클릭하고 화면에 표시된 안내를 따릅니다. Google Cloud 프로젝트를 만드는 경우 프로젝트에 결제를 사용 설정해야 할 수 있습니다.

Chat API 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 API를 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

  • Google Cloud 콘솔에서 Google Chat API를 사용 설정합니다.

    API 사용 설정

OAuth 2.0을 사용하는 모든 앱에는 동의 화면 구성이 필요합니다. 앱의 OAuth 동의 화면을 구성하면 사용자와 앱 검토자에게 표시되는 내용을 정의하고 나중에 게시할 수 있도록 앱이 등록됩니다.

  1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.

    OAuth 동의 화면으로 이동

  2. 앱의 사용자 유형을 선택한 다음 만들기를 클릭합니다.
  3. 앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.

  4. 지금은 범위 추가를 건너뛰고 저장하고 계속하기를 클릭해도 됩니다. 앞으로 Google Workspace 조직 외부에서 사용할 앱을 만들 때는 앱에 필요한 승인 범위를 추가하고 확인해야 합니다.

  5. 사용자 유형으로 외부를 선택한 경우 테스트 사용자를 추가합니다.
    1. 테스트 사용자에서 사용자 추가를 클릭합니다.
    2. 이메일 주소 및 승인된 다른 테스트 사용자를 입력한 다음 저장하고 계속하기를 클릭합니다.
  6. 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 확인되면 대시보드로 돌아가기를 클릭합니다.

스크립트 설정

스크립트를 설정하려면 템플릿을 사용한 다음 Apps Script에서 클라우드 프로젝트를 설정합니다.

템플릿에서 스크립트 만들기

  1. Apps Script 시작하기 페이지로 이동합니다.
  2. Chat App 템플릿을 클릭합니다. 이 템플릿을 보려면 아래로 스크롤해야 할 수 있습니다
  3. 제목 없는 프로젝트를 클릭하고 Quickstart app를 입력한 후 이름 바꾸기를 클릭합니다.

Cloud 프로젝트 번호 복사

  1. Google Cloud 콘솔에서 Cloud 프로젝트로 이동합니다.
  2. 설정 및 유틸리티 > 프로젝트 설정을 클릭합니다.
  3. 프로젝트 번호를 복사합니다.

Apps Script 프로젝트의 클라우드 프로젝트 설정

  1. 채팅 앱 Apps Script 프로젝트에서 프로젝트 설정 프로젝트 설정 아이콘을 클릭합니다.
  2. Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
  3. GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
  4. 프로젝트 설정을 클릭합니다.

이제 다음 단계에 설명된 대로 사용해 보고 요구사항에 맞게 맞춤설정할 수 있는 작동하는 앱 코드가 생겼습니다.

Apps Script 템플릿을 열 때 올바른 Google 계정에 로그인했는지 확인합니다. 때로는 현재 계정이 사용자가 알지 못하는 사이에 기본 계정으로 전환될 수도 있습니다.

테스트 배포 만들기

이 Apps Script 프로젝트의 배포 ID가 있어야 다음 단계에서 사용할 수 있습니다.

헤드 배포 ID를 가져오려면 다음 단계를 따르세요.

  1. 채팅 앱 Apps Script 프로젝트에서 배포 > 배포 테스트를 클릭합니다.
  2. 이후 단계에서 사용할 수 있도록 헤드 배포 ID를 복사하고 완료를 클릭합니다.

채팅 앱 게시하기

Google Cloud 콘솔에서 채팅 앱을 게시합니다.

  1. Google Cloud 콘솔에서 Google Chat API를 검색하고 Google Chat API를 클릭합니다.
  2. 관리를 클릭합니다.

  3. Configuration을 클릭하고 채팅 앱을 설정합니다.

    1. 앱 이름 필드에 Quickstart app를 입력합니다.
    2. 아바타 URL 필드에 https://developers.google.com/chat/images/quickstart-app-avatar.png를 입력합니다.
    3. 설명 필드에 Quickstart app을 입력합니다.
    4. 기능에서 1:1 메시지 수신 및 스페이스 및 그룹 대화 참여를 선택합니다.
    5. 연결 설정에서 Apps Script 프로젝트를 선택하고 배포 ID를 필드에 붙여넣습니다.
    6. 공개 상태에서 도메인의 특정 사용자 및 그룹을 선택하고 이메일을 입력합니다.

  4. 저장을 클릭하고 페이지를 새로고침합니다.

  5. 구성 페이지의 앱 상태에서 상태를 실시간 - 사용자가 사용할 수 있음으로 설정합니다.

  6. 저장을 클릭합니다.

채팅 앱이 메시지에 응답할 준비가 되었습니다.

채팅 앱 테스트

  1. Chat을 엽니다.
  2. 채팅 시작 > 앱 찾기를 클릭하여 새 직접 메시지를 앱으로 전송합니다.
  3. 앱 찾기 페이지에서 Quickstart App을 검색합니다.
  4. 빠른 시작 앱 옆의 채팅을 클릭합니다.
  5. 앱의 새 직접 메시지에 Hello를 입력하고 enter를 누릅니다.

앱을 추가해 주셔서 감사하며 메시지가 표시됩니다.

다음 단계

  • 양방향 카드 만들기 - 카드 메시지는 정의된 레이아웃, 대화형 UI 요소(예: 버튼), 리치 미디어(예: 이미지)를 지원합니다. 카드 메시지를 사용하여 자세한 정보를 표시하고 사용자로부터 정보를 수집하며 사용자에게 다음 단계를 안내합니다.
  • 슬래시 명령어 지원–슬래시 명령어를 사용하면 사용자가 슬래시(/)로 시작하는 명령어(예: /help)를 입력하여 앱에 제공할 수 있는 특정 명령어를 등록하고 알릴 수 있습니다.
  • 실행 대화상자 - 대화상자는 앱이 사용자와 상호작용하기 위해 열 수 있는 창 형식의 카드 기반 인터페이스입니다. 여러 카드를 순차적으로 함께 연결할 수 있어 사용자가 양식 데이터 입력과 같은 다단계 프로세스를 완료할 수 있습니다.