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 지도나 YouTube와 같은 다른 Google 서비스와 통합할 수 있습니다.
  4. 채팅 앱 로직은 Chat의 채팅 앱 서비스로 응답을 다시 보냅니다.
  5. 응답은 사용자에게 전달됩니다.

목표

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

기본 요건

환경 설정하기

Google Cloud 콘솔에서 Cloud 프로젝트 열기

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

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

    Cloud 프로젝트 선택

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

Chat API 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 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. 구성을 클릭하고 채팅 앱을 설정합니다.

    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를 누릅니다.

채팅 앱을 추가해 주셔서 감사하며 메시지를 되풀이합니다.

신뢰할 수 있는 테스터를 추가하고 양방향 기능 테스트에 관한 자세한 내용은 Google Chat 앱의 양방향 기능 테스트를 참고하세요.

다음 단계

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