이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Apps Script로 Google Chat 앱 빌드하기

채팅 메시지를 보내고 메시지를 주고받을 수 있는 Google Chat 앱을 만듭니다. 응답합니다.

다음 다이어그램은 아키텍처 및 메시징 패턴을 보여줍니다.

Apps Script로 구현된 채팅 앱 아키텍처

위 다이어그램에서 Apps Script와 상호작용하는 사용자는 채팅 앱에는 다음과 같은 정보 흐름이 있습니다.

사용자가 채팅 앱에서 Chat 스페이스에서 채팅 메시지를 보낼 수 있습니다.
다음에서 구현된 채팅 앱 로직 Google Cloud에 있는 Apps Script는 메시지를 처리합니다
채팅 앱 로직은 원하는 경우 Google Workspace 서비스(예: Calendar, Sheets 또는 기타 Google 서비스(예: Google 지도) 또는 YouTube일 수 있습니다.
채팅 앱 로직은 Chat의 채팅 앱 서비스입니다.
응답이 사용자에게 전달됩니다.

목표

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

기본 요건

비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
Google Cloud 프로젝트 생성 방법은 다음을 참고하세요. Google Cloud 프로젝트를 만듭니다.

환경 설정

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

아직 열려 있지 않으면 사용할 Cloud 프로젝트를 엽니다. 다음을 참조하세요.

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

Chat API 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

Google Cloud 콘솔에서 Google Chat API를 사용 설정합니다.

API 사용 설정

OAuth 동의 화면 구성

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

Google Cloud 콘솔에서 메뉴 로 이동합니다. > API 및 서비스 > OAuth 동의 화면.
OAuth 동의 화면으로 이동
사용자 유형으로 내부를 선택한 다음 만들기를 클릭합니다.
앱 등록 양식을 작성한 다음 저장하고 계속하기를 클릭합니다.
지금은 범위 추가를 건너뛰고 저장 후 계속을 클릭할 수 있습니다. 나중에 외부에서 사용하기 위해 앱을 만들 때 Google Workspace 조직의 경우 사용자 유형을 외부로 변경한 다음 앱에 필요한 승인 범위를 추가합니다.
앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱이 등록이 확인되면 대시보드로 돌아가기를 클릭합니다.

스크립트 설정

스크립트를 설정하려면 템플릿을 사용한 다음 Apps Script의 Cloud 프로젝트

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

다음으로 이동: Apps Script 시작하기 페이지.
Chat App 템플릿을 클릭합니다. 경우에 따라 아래로 스크롤해야 할 수 있습니다. 이 템플릿을 볼 수 있습니다.
제목 없는 프로젝트를 클릭하고 Quickstart app를 입력합니다. 이름 바꾸기를 클릭합니다.

Cloud 프로젝트 번호를 복사합니다.

Google Cloud 콘솔에서 메뉴 로 이동합니다. > IAM 및 관리자 > 설정을 탭합니다.
IAM & 관리자 설정으로 이동
프로젝트 번호 필드에 값을 복사합니다.

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

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

이제 실제로 작동하는 앱 코드를 사용해 볼 수 있습니다 (자세한 내용은 다음 단계)에 맞게 맞춤설정합니다.

Google 검색 앱을 열 때 올바른 Google 계정에 Apps Script 템플릿. 현재 계정은 경우에 따라 기본 계정으로 전환된다는 의미입니다.

테스트 배포 만들기

이 Apps Script 프로젝트에 대한 배포 ID가 필요하므로 다음 단계에서 사용할 수 있습니다.

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

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

채팅 앱 게시

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

Google Cloud 콘솔 Google Chat API를 검색하고 Google Chat API를 클릭합니다.
관리를 클릭합니다.
구성을 클릭하고 채팅 앱을 설정합니다.
1. 앱 이름 필드에 Quickstart app를 입력합니다.
2. 아바타 URL 입력란에 https://developers.google.com/chat/images/quickstart-app-avatar.png입니다.
3. 설명 필드에 Quickstart app을 입력합니다.
4. 기능에서 1:1 메시지 수신을 선택하고 스페이스 및 그룹 대화에 참여하기
5. 연결 설정에서 Apps Script 프로젝트를 선택합니다.
6. 배포 ID 필드에 생성한 헤드 배포 ID를 붙여넣습니다. 복사되었습니다.
7. 공개 설정에서 내 계정의 특정 사용자 및 그룹 도메인을 클릭하고 이메일을 입력합니다.
저장을 클릭합니다.

채팅 앱이 메시지에 응답할 준비가 되었습니다.

채팅 앱 테스트

채팅 앱을 테스트하려면 다음을 사용하여 채팅 메시지 스페이스를 엽니다. 채팅 앱을 열고 메시지를 보내세요.

사용하는 Google Workspace 계정을 사용하여 Google Chat을 엽니다. 제공됩니다.

Google Chat으로 이동
새 채팅을 클릭합니다.
1명 이상 사용자 추가 입력란에 채팅 앱
검색 결과에서 채팅 앱을 선택합니다. 직접 메시지가 열립니다.

참고: 사용 중인 채팅 앱이 Google Workspace 계정이 Chat API 구성의 공개 상태 설정 페이지를 참조하세요.
앱과의 새 채팅 메시지에 Hello를 입력하고 enter 키를 누릅니다.

채팅 앱에서 추가해 주셔서 감사하고 에코가 울립니다. 메시지를 보냅니다.

신뢰할 수 있는 테스터를 추가하고 양방향 기능 테스트에 관해 자세히 알아보려면 다음을 참고하세요. Google의 양방향 기능 테스트 Google Chat 앱.

문제 해결

Google Chat 앱 또는 card가 오류를 반환하는 경우 Chat 인터페이스에 '문제가 발생했습니다'라는 메시지가 표시됨 또는 '요청을 처리할 수 없습니다'와 같은 메시지가 표시됩니다. 채팅 UI가 오류 메시지가 표시되지 않지만 채팅 앱 또는 카드에서 예기치 않은 결과가 발생합니다. 예를 들어 카드 메시지가 나타납니다.

채팅 UI에 오류 메시지가 표시되지 않을 수도 있지만 오류 해결에 도움이 되는 오류 메시지 및 로그 데이터를 사용할 수 있음 채팅 앱의 오류 로깅이 사용 설정된 경우 보는 데 도움이 필요한 경우 오류를 수정하는 방법에 대한 자세한 내용은 Google Chat 오류 문제 해결하기

삭제

서비스 요금이 Google Cloud 계정에 청구되지 않도록 리소스 사용을 중단하려면 Cloud 프로젝트입니다.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.

프로젝트의 모든 항목이 삭제됩니다. 이 튜토리얼의 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com의 URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내의 선택한 리소스만 삭제하세요.

여러 튜토리얼과 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다. 클릭 메뉴 > IAM 및 관리자 > 리소스 관리를 클릭합니다.
<ph type="x-smartling-placeholder"></ph> Resource Manager로 이동 를 통해 개인정보처리방침을 정의할 수 있습니다.
프로젝트 목록에서 삭제할 프로젝트를 선택한 후 를 삭제합니다.
대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 삭제합니다. 프로젝트입니다

다음 단계

양방향 카드 만들기: 카드 메시지는 정의된 레이아웃, 버튼과 같은 대화형 UI 요소를 지원하며 사용할 수 있습니다. 카드 메시지를 사용하여 자세한 정보를 제시하고 사용자로부터 정보를 수집하고, 사용자가 다음 단계로 나아갈 수 있도록 안내합니다.
슬래시 명령어 지원: 슬래시 명령어 지원 사용자가 앱에 지정할 수 있는 특정 명령어를 등록하고 광고 슬래시(/)로 시작하는 명령어(예: /help)를 입력하세요.
실행 대화상자: 창으로 표시되는 카드 기반의 대화상자 인터페이스를 제공하여 앱에서 사용자와 상호작용할 수 있도록 합니다. 여러 카드 순차적으로 묶을 수 있어 사용자가 여러 단계를 완료할 수 있습니다. 예를 들어 양식 데이터 입력과 같은 프로세스를 자동화합니다
Codelab: 고급 빌드 준비 완료 채팅 앱 의견 보기 Codelab의 채팅 앱 Gemini로 Google Chat용 앱 빌드하기