만드는 각 Google Chat 앱에는 Chat API가 사용 설정되고 구성된 자체 Google Cloud 프로젝트가 있어야 합니다. 이 페이지에서는 Chat API를 구성하는 방법을 설명합니다.
기본 요건
Chat API 구성
Google Cloud 콘솔에서 'Google Chat API'를 검색하고 Google Chat API를 클릭한 후 관리를 클릭합니다.
구성 탭을 클릭하고 다음 필수 정보를 입력합니다.
- 앱 이름: 사용자가 채팅 앱과 상호작용할 때 사용하는 이름입니다.
- 아바타 URL: 128x128 이상의 정사각형 그래픽 이미지를 가리키는 HTTPS URL로, 채팅 앱의 아바타로 표시됩니다.
- 설명: 채팅 앱 이름 아래에 표시되는 채팅 앱의 의도된 목적에 관한 설명입니다.
대화형 기능을 사용 설정하려면 사용자가 채팅 앱과 상호작용할 수 있는 대화형 기능 사용 설정 전환 버튼을 클릭하고 다음 표를 사용하여 구성을 완료할 수 있습니다.
필드 설명 기능 채팅 앱이 사용자와 상호작용할 수 있는 방법을 결정하는 필드 집합입니다. - 1:1 메시지 수신: 사용자가 Google Chat에서 직접 채팅 앱을 찾아 메시지를 보낼 수 있습니다.
- 스페이스 및 그룹 대화 참여: 사용자가 스페이스 및 그룹 대화에 Chat 앱을 추가할 수 있습니다.
연결 설정 채팅 앱의 엔드포인트로 다음 중 하나입니다. - 앱 URL: 채팅 앱 구현을 호스팅하는 HTTPS 엔드포인트입니다.
- Apps Script 프로젝트: 채팅 앱을 구현하는 Apps Script 프로젝트의 배포 ID입니다.
- Cloud Pub/Sub 주제 이름: 채팅 앱이 엔드포인트로 구독하는 Pub/Sub 주제입니다.
- Dialogflow: Dialogflow 통합으로 채팅 앱을 등록합니다. 자세한 내용은 자연어를 이해하는 Dialogflow Google Chat 앱 빌드를 참조하세요.
슬래시 명령어 Google Chat 내에서 사용자에게 표시할 수 있는 명령어입니다. 사용자가 Google Chat 내에서 채팅 앱의 핵심 작업을 확인하고 상호작용할 특정 작업을 선택할 수 있도록 허용합니다. 자세한 내용은 채팅 앱으로 슬래시 명령어에 응답하기를 참고하세요. 링크 미리보기 사용자가 링크를 보낼 때 채팅 앱에서 인식하고 추가 콘텐츠를 제공하는 URL 패턴입니다. 자세한 내용은 미리보기 링크를 참고하세요. 공개 상태 채팅 앱을 보고 설치할 수 있는 최대 5명의 개인 또는 하나 이상의 Google 그룹스입니다. 이 필드를 사용하여 채팅 앱을 테스트하거나 팀과 채팅 앱을 공유할 수 있습니다. 자세한 내용은 Chat 앱의 공개 상태 및 게시 설정을 참고하세요. 채팅 앱에서 오류를 반환할 때마다 Cloud Logging에 오류를 로깅하려면 Logging에 오류를 로깅 체크박스를 선택합니다. 자세한 내용은 Chat 앱의 오류 로그 쿼리를 참고하세요.
저장을 클릭합니다. 채팅 앱 구성을 저장하면 Google Workspace 조직의 지정된 사용자가 채팅 앱을 사용할 수 있습니다.
채팅 앱을 구성할 수 있는 권한을 다른 사용자에게 부여하기
채팅 앱 구성 페이지에 대한 특정 사용자에게 액세스 권한을 부여할 수 있습니다. 채팅 앱 소유자 및 채팅 앱 뷰어 IAM 역할을 사용합니다. 이러한 역할이 있는 사용자는 API 및 서비스 대시보드를 사용하여 채팅 앱 구성 페이지로 이동할 수 없지만 다음과 같이 채팅 앱의 호스트 Cloud 프로젝트용 Google Cloud 콘솔로 이동하여 구성 페이지에 액세스할 수 있습니다.
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
여기서 PROJECT_ID는 채팅 앱을 호스팅하는 Google Cloud 프로젝트의 프로젝트 ID입니다.