직접 메시지를 보낼 수 있고 메시지를 에코하여 응답하는 Google Chat 앱을 만듭니다.
목표
- 환경을 설정합니다.
- 스크립트를 설정합니다.
- 앱을 게시합니다.
- 스크립트를 실행합니다.
기본 요건
- Chat 액세스 권한이 있는 Google Workspace 계정.
- Google Cloud 프로젝트
환경 설정
Google Cloud 콘솔에서 Cloud 프로젝트 열기
아직 열려 있지 않은 경우 이 샘플에 사용할 Cloud 프로젝트를 엽니다.
- Google Cloud 콘솔에서 프로젝트 선택 페이지로 이동합니다.
- 사용할 Google Cloud 프로젝트를 선택합니다. 또는 프로젝트 만들기를 클릭하고 화면에 표시된 안내를 따릅니다. Google Cloud 프로젝트를 만드는 경우 프로젝트에 결제를 사용 설정해야 할 수 있습니다.
Chat API 사용 설정하기
Google API를 사용하기 전에 Google Cloud 프로젝트에서 이를 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.Google Cloud 콘솔에서 Google Chat API를 사용 설정합니다.
OAuth 동의 화면 구성
OAuth 2.0을 사용하는 모든 앱에는 동의 화면 구성이 필요합니다. 앱의 OAuth 동의 화면을 구성하면 사용자와 앱 검토자에게 표시되는 항목이 정의되며 나중에 게시할 수 있도록 앱을 등록합니다.
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.
- 앱의 사용자 유형을 선택한 다음 만들기를 클릭합니다.
- 앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.
지금은 범위 추가를 건너뛰고 저장하고 계속하기를 클릭합니다. 향후 Google Workspace 조직 외부에서 사용할 앱을 만들 때는 앱에 필요한 승인 범위를 추가하고 확인해야 합니다.
- 사용자 유형으로 외부를 선택한 경우 테스트 사용자를 추가합니다.
- 테스트 사용자에서 사용자 추가를 클릭합니다.
- 이메일 주소와 기타 승인된 테스트 사용자를 입력한 후 저장 후 계속을 클릭합니다.
- 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 괜찮아 보이면 대시보드로 돌아가기를 클릭합니다.
스크립트 설정하기
스크립트를 설정하려면 템플릿을 사용한 다음 Apps Script에서 Cloud 프로젝트를 설정합니다.
템플릿에서 스크립트 만들기
- Apps Script 시작하기 페이지로 이동합니다.
- Chat 앱 템플릿을 클릭합니다. 이 템플릿을 보려면 아래로 스크롤해야 할 수도 있습니다.
- 제목 없는 프로젝트를 클릭하고
Quickstart app
을 입력한 후 이름 바꾸기를 클릭합니다.
Cloud 프로젝트 번호 복사
- Google Cloud 콘솔에서 Cloud 프로젝트로 이동합니다.
- 설정 및 유틸리티 > 프로젝트 설정을 클릭합니다.
- 프로젝트 번호를 복사합니다.
Apps Script 프로젝트의 Cloud 프로젝트 설정
- Chat 앱 Apps Script 프로젝트에서 프로젝트 설정
을 클릭합니다.
- Google Cloud Platform (GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
- 프로젝트 설정을 클릭합니다.
이제 다음 단계에 설명된 대로 작동하는 앱 코드를 사용해 본 다음 요구사항을 충족하도록 맞춤설정할 수 있습니다.
Apps Script 템플릿을 열 때 올바른 Google 계정으로 로그인해야 합니다. 현재 계정은 때로 알아차리지 않고 기본 계정으로 전환될 수 있습니다.
테스트 배포 만들기
다음 단계에서 사용할 수 있도록 이 Apps Script 프로젝트의 배포 ID가 필요합니다.
헤드 배포 ID를 가져오려면 다음 단계를 따르세요.
- Chat 앱 Apps Script 프로젝트에서 배포 > 테스트 배포를 클릭합니다.
- 이후 단계에서 사용할 헤드 배포 ID를 복사하고 완료를 클릭합니다.
Chat 앱 게시하기
Google Cloud 콘솔에서 Chat 앱을 게시합니다.
- Google Cloud Console에서
Google Chat API
를 검색하고 Google Chat API를 클릭합니다. - 관리를 클릭합니다.
구성을 클릭하고 Chat 앱을 설정합니다.
- 앱 이름 필드에
Quickstart app
을 입력합니다. - 아바타 URL 필드에
https://developers.google.com/chat/images/quickstart-app-avatar.png
를 입력합니다. - 설명 필드에
Quickstart app
을 입력합니다. - '기능'에서 1:1 메시지 수신 및 스페이스 및 그룹 대화 참여를 선택합니다.
- 연결 설정에서 Apps Script 프로젝트를 선택한 후 필드에 배포 ID를 붙여넣습니다.
- 권한에서 도메인의 특정 사용자 및 그룹을 선택하고 이메일을 입력합니다.
- 앱 이름 필드에
저장을 클릭하고 페이지를 새로고침합니다.
구성 페이지의 앱 상태에서 상태를 라이브 - 사용자에게 제공으로 설정합니다.
저장을 클릭합니다.
Chat 앱에서 메시지에 응답할 준비가 되었습니다.
스크립트 실행
- Chat을 엽니다.
- 채팅 시작 > 앱 찾기를 클릭하여 새 직접 메시지를 앱으로 전송합니다.
- 앱 찾기 페이지에서
Quickstart App
를 검색합니다. - 빠른 시작 앱 옆에 있는 채팅을 클릭합니다.
- 앱의 새 직접 메시지에
Hello
를 입력하고enter
를 누릅니다.
앱을 추가해 주셔서 감사합니다. 메시지를 확인해 주셔서 감사합니다.
다음 단계
- 양방향 카드 만들기: 카드 메시지는 정의된 레이아웃, 버튼과 같은 대화형 UI 요소, 이미지와 같은 리치 미디어를 지원합니다. 카드 메시지를 사용하여 자세한 정보를 표시하고, 사용자로부터 정보를 수집하고, 사용자가 다음 단계를 진행하도록 안내하세요.
- 슬래시 명령어 지원: 슬래시 명령어를 사용하면
/help
와 같이 슬래시 (/
)로 시작하는 명령어를 입력하여 사용자가 앱에 제공할 수 있는 특정 명령어를 등록하고 알릴 수 있습니다. - Launch 대화상자: 대화상자가 카드 형식의 인터페이스이며 앱에서 사용자와 상호작용할 수 있습니다. 여러 카드를 순차적으로 함께 사용할 수 있어 사용자가 양식 데이터 입력 등 다단계 프로세스를 완료하는 데 도움이 됩니다.