Google Chat API 구성

Google Chat 앱을 만드는 데는 Chat API가 사용 설정되고 구성된 자체 Google Cloud 프로젝트가 필요합니다. 이 페이지에서는 Chat API를 구성하는 방법을 보여줍니다.

기본 요건

Chat API 구성

  1. Google Cloud 콘솔에서 'Google Chat API'를 검색하고 Google Chat API를 클릭한 다음 관리를 클릭합니다.

    Chat API로 이동

  2. 구성 탭을 클릭하고 다음 필수 정보를 입력합니다.

    • 앱 이름: 사용자가 채팅 앱과 상호작용할 때 사용하는 이름입니다.
    • 아바타 URL: 채팅 앱의 아바타로 표시되는 128x128 이상의 정사각형 그래픽 이미지(예: PNG 또는 JPEG)를 가리키는 HTTPS URL입니다.
    • 설명: 채팅 앱의 이름 아래에 표시되는 채팅 앱의 의도된 목적에 관한 설명입니다.
  3. 양방향 기능을 사용 설정하려면 사용자가 채팅 앱과 상호작용할 수 있도록 양방향 기능 사용 설정 전환 버튼을 클릭하고 다음 표를 사용하여 구성을 완료합니다.

    필드 설명
    기능 채팅 앱이 사용자와 상호작용하는 방법을 결정하는 필드 모음:
    • 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 그룹스입니다. 이 필드를 사용하여 채팅 앱을 테스트하거나 채팅 앱을 팀과 공유하세요. 자세한 내용은 채팅 앱의 공개 상태 및 게시 설정을 참고하세요.
  4. Chat 앱에서 오류를 반환할 때마다 Cloud Logging에 오류를 로깅하려면 Logging에 오류 로깅 체크박스를 선택합니다. 자세한 내용은 채팅 앱의 오류 로그 쿼리를 참고하세요.

  5. 저장을 클릭합니다. 채팅 앱 구성을 저장하면 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입니다.