Google Apps Script 채팅 앱

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

목표

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

기본 요건

환경 설정

이 빠른 시작을 완료하려면 환경을 설정하세요.

API 사용 설정

Google API를 사용하기 전에 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.
  • Google Cloud Console에서 Google Chat API를 사용 설정합니다.

    API 사용 설정

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

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

    OAuth 동의 화면으로 이동

  2. 앱의 사용자 유형을 선택한 다음 만들기를 클릭합니다.
  3. 앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.
  4. Google Workspace 조직 외부에서 사용할 앱을 만드는 경우 범위 추가 또는 삭제를 클릭합니다. 앱에 필요한 승인 범위를 추가하고 확인한 다음 저장하고 계속하기를 클릭합니다.

    일부 범위에는 Google의 추가 검토가 필요합니다. Google Workspace 조직에서만 사용하는 앱의 경우 범위가 동의 화면에 표시되지 않으며 제한적이거나 민감한 범위를 사용할 경우 Google의 추가 검토가 필요하지 않습니다. 자세한 내용은 앱 범위를 선택하는 방법을 참고하세요.

  5. 테스트 사용자에서 사용자 추가를 클릭합니다.
  6. 이메일 주소와 기타 승인된 테스트 사용자를 입력한 후 저장 후 계속을 클릭합니다.
  7. 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 괜찮아 보이면 대시보드로 돌아가기를 클릭합니다.

스크립트 만들기

스크립트를 만들려면 템플릿을 사용한 다음 Apps Script에서 Cloud 프로젝트를 설정하세요.

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

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

Cloud 프로젝트 번호 복사

  1. Google Cloud Console로 이동합니다.
  2. 필요한 경우 이 빠른 시작에 사용할 Cloud 프로젝트를 엽니다.
    1. Google Cloud 옆의 아래쪽 화살표 를 클릭합니다. 현재 프로젝트를 나열하는 대화상자가 나타납니다.
    2. 프로젝트를 선택하고 열기를 클릭합니다. Console에서 프로젝트가 열립니다.
  3. 설정 및 유틸리티 > 프로젝트 설정을 클릭합니다.
  4. 프로젝트 번호를 복사합니다.

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

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

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

Apps Script 템플릿을 열 때 올바른 Google 계정으로 로그인해야 합니다. 현재 계정은 모르는 사이에 기본 계정으로 전환할 수 있습니다.

배포 ID 가져오기

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

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

  1. Chat 앱 Apps Script 프로젝트에서 배포>신규 배포를 클릭합니다.
  2. 유형 선택에서 부가기능을 클릭합니다.
  3. 옵션을 입력하고 배포를 클릭합니다.
  4. 배포 ID에서 복사를 클릭합니다.

Chat 앱 게시하기

Google Cloud Console에서 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. 저장을 클릭합니다.

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

샘플 실행

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

앱을 추가해 주셔서 감사하고 메시지를 반영할 수 있었습니다.

다음 단계

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