직접 메시지를 보내고 메시지를 에코하여 응답하는 Google Chat 앱을 만듭니다.
다음 다이어그램은 아키텍처와 메시지 패턴을 보여줍니다.
위의 다이어그램에서 Apps Script Chat 앱과 상호작용하는 사용자는 다음과 같은 정보 흐름을 보입니다.
- 사용자가 채팅 메시지 또는 Chat 스페이스를 통해 채팅 앱에 메시지를 보냅니다.
- Google Cloud에 있는 Apps Script에 구현된 채팅 앱 로직이 메시지를 수신하고 처리합니다.
- 원하는 경우 채팅 앱 로직을 Calendar나 Sheets와 같은 Google Workspace 서비스 또는 Google 지도나 YouTube와 같은 다른 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에서 클라우드 프로젝트를 설정합니다.
템플릿에서 스크립트 만들기
- Apps Script 시작하기 페이지로 이동합니다.
- Chat App 템플릿을 클릭합니다. 이 템플릿을 보려면 아래로 스크롤해야 할 수도 있습니다
- 제목 없는 프로젝트를 클릭하고
Quickstart app
를 입력한 후 이름 바꾸기를 클릭합니다.
Cloud 프로젝트 번호 복사
- Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 설정으로 이동합니다.
- 프로젝트 번호 필드에서 값을 복사합니다.
Apps Script 프로젝트의 클라우드 프로젝트 설정
- 채팅 앱 Apps Script 프로젝트에서 프로젝트 설정 을 클릭합니다.
- Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
- GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
- 프로젝트 설정을 클릭합니다.
이제 다음 단계에 설명된 대로 시도해 본 후 요구사항에 맞게 맞춤설정할 수 있는 작동하는 앱 코드가 생겼습니다.
Apps Script 템플릿을 열 때 올바른 Google 계정에 로그인했는지 확인합니다. 현재 계정이 때로는 모르는 사이에 기본 계정으로 전환될 수 있습니다.
테스트 배포 만들기
다음 단계에서 사용할 수 있도록 이 Apps Script 프로젝트의 배포 ID가 필요합니다.
헤드 배포 ID를 가져오려면 다음 단계를 따르세요.
- 채팅 앱 Apps Script 프로젝트에서 배포 > 배포 테스트를 클릭합니다.
- 이후 단계에서 사용할 헤드 배포 ID를 복사하고 완료를 클릭합니다.
채팅 앱 게시
Google Cloud 콘솔에서 채팅 앱을 게시합니다.
- Google Cloud 콘솔에서
Google Chat API
를 검색하고 Google Chat API를 클릭합니다. - 관리를 클릭합니다.
구성을 클릭하고 채팅 앱을 설정합니다.
- 앱 이름 필드에
Quickstart app
를 입력합니다. - 아바타 URL 필드에
https://developers.google.com/chat/images/quickstart-app-avatar.png
를 입력합니다. - 설명 필드에
Quickstart app
을 입력합니다. - 기능에서 1:1 메시지 수신 및 스페이스 및 그룹 대화 참여를 선택합니다.
- 연결 설정에서 Apps Script 프로젝트를 선택합니다.
- 배포 ID 필드에 이전에 복사한 헤드 배포 ID를 붙여넣습니다.
- 공개 상태에서 내 도메인의 특정 사용자 및 그룹을 선택하고 이메일을 입력합니다.
- 앱 이름 필드에
저장을 클릭합니다.
채팅 앱에서 메시지에 응답할 준비가 되었습니다.
채팅 앱 테스트
채팅 앱을 테스트하려면 채팅 앱이 있는 채팅 메시지 공간을 열고 메시지를 보냅니다.
본인을 신뢰할 수 있는 테스터로 추가할 때 입력한 Google Workspace 계정을 사용하여 Google Chat을 엽니다.
- 새 채팅을 클릭합니다.
- 1명 이상의 사용자 추가 필드에 채팅 앱의 이름을 입력합니다.
결과에서 채팅 앱을 선택합니다. 채팅 메시지가 열립니다.
앱과의 새 채팅 메시지에
Hello
를 입력하고enter
를 누릅니다.Chat 앱은 앱을 추가해 주셔서 감사하며 사용자의 메시지를 되풀이합니다.
신뢰할 수 있는 테스터를 추가하고 양방향 기능 테스트에 관한 자세한 내용은 Google Chat 앱의 양방향 기능 테스트를 참고하세요.
문제 해결
Google Chat 앱 또는 카드에서 오류를 반환하면 Chat 인터페이스에 '문제 발생'이라는 메시지가 표시됩니다. 또는 '요청을 처리할 수 없습니다.' 채팅 UI에는 오류 메시지가 표시되지 않지만 채팅 앱 또는 카드에서 예기치 않은 결과가 발생할 수 있습니다. 예를 들어 카드 메시지가 표시되지 않을 수 있습니다.
Chat UI에 오류 메시지가 표시되지 않더라도 채팅 앱의 오류 로깅이 사용 설정된 경우 오류를 수정하는 데 도움이 되는 설명적 오류 메시지와 로그 데이터가 제공됩니다. 오류 보기, 디버깅, 수정에 관한 도움말은 Google Chat 오류 문제 해결 및 수정하기를 참고하세요.
삭제
이 튜토리얼에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 Cloud 프로젝트를 삭제하는 것이 좋습니다.
- Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다. 메뉴 > IAM 및 관리자 > 리소스 관리를 클릭합니다.
- 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제 를 클릭합니다.
- 대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 프로젝트를 삭제합니다.
다음 단계
- 양방향 카드 만들기 - 카드 메시지는 정의된 레이아웃, 대화형 UI 요소(예: 버튼), 리치 미디어(예: 이미지)를 지원합니다. 카드 메시지를 사용하여 자세한 정보를 표시하고 사용자로부터 정보를 수집하며 사용자에게 다음 단계를 안내하세요.
- 슬래시 명령어 지원 – 슬래시 명령어를 사용하면 사용자가 슬래시(
/
)로 시작하는 명령어(예:/help
)를 입력하여 앱에 제공할 수 있는 특정 명령어를 등록하고 광고할 수 있습니다. - 실행 대화상자 - 대화상자는 창이 있는 카드 기반 인터페이스로 앱에서 사용자와 상호작용하기 위해 열 수 있습니다. 여러 카드를 순차적으로 연결할 수 있어 사용자가 양식 데이터 입력과 같은 다단계 프로세스를 완료할 수 있습니다.
- Gemini로 Google Chat용 앱 빌드 Codelab의 의견 채팅 앱을 참고하세요. Codelab: 고급 채팅 앱을 빌드할 준비가 되셨나요?