Google Apps Script 채팅 앱 빠른 시작

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

목표

  • 환경을 설정합니다.
  • 스크립트를 설정합니다.
  • 앱을 게시합니다.
  • 스크립트를 실행합니다.

기본 요건

환경 설정

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에서 Cloud 프로젝트를 설정합니다.

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

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

Cloud 프로젝트 번호 복사

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

Apps Script 프로젝트의 Cloud 프로젝트 설정

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

이제 다음 단계에 설명된 대로 작동하는 앱 코드를 사용해 본 다음 요구사항을 충족하도록 맞춤설정할 수 있습니다.

Apps Script 템플릿을 열 때 올바른 Google 계정으로 로그인해야 합니다. 현재 계정은 때로 알아차리지 않고 기본 계정으로 전환될 수 있습니다.

테스트 배포 만들기

다음 단계에서 사용할 수 있도록 이 Apps Script 프로젝트의 배포 ID가 필요합니다.

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

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

Chat 앱 게시하기

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

  1. Google Cloud Console에서 Google Chat API를 검색하고 Google Chat API를 클릭합니다.
  2. 관리를 클릭합니다.
  3. 구성을 클릭하고 Chat 앱을 설정합니다.

    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. 저장을 클릭합니다.

Chat 앱에서 메시지에 응답할 준비가 되었습니다.

스크립트 실행

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

앱을 추가해 주셔서 감사합니다. 메시지를 확인해 주셔서 감사합니다.

다음 단계

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