이 페이지에서는 Google Chat을 확장하는 Google Workspace 부가기능을 빌드하는 방법을 간략히 설명합니다.
Chat을 확장하는 Google Workspace 부가기능을 사용하면 사용자가 다음 작업을 할 수 있습니다.
- Chat 메시지의 링크를 미리 보고 대화에서 나가지 않고도 작업을 실행할 수 있습니다.
- Google Workspace 애플리케이션 전반에서 작업을 자동화하거나 실행합니다.
- 외부 도구 또는 서비스에 대한 알림을 받습니다.
Chat에서 Google Workspace 부가기능이 작동하는 방식
Chat에서 부가기능은 사용자에게 Google Chat 앱으로 표시됩니다. 채팅 앱은 사용자와 상호작용하기 위해 다음을 실행할 수 있습니다.
- 텍스트, 카드, 양방향 UI 요소가 포함된 메시지 보내기
- 슬래시 명령어에 응답합니다.
- 대화상자를 열어 사용자가 양식 데이터 작성과 같은 다단계 프로세스를 완료하도록 지원합니다.
- 사용자가 대화에서 바로 조치를 취할 수 있는 유용한 정보가 포함된 카드를 첨부하여 메시지에서 링크를 미리 볼 수 있습니다.
시작하기
Chat에서 작동하는 Google Workspace 부가기능을 빌드하려면 다음 문서를 참고하세요.
- 빠른 시작을 통해 Google Apps Script 또는 HTTP 서비스를 사용하여 기본 Chat 앱을 빌드해 보세요.
- Chat API를 사용하여 Chat 앱 및 대화형 기능을 구성합니다.
- 부가기능 트리거, 작업, 이벤트 객체를 사용하여 Chat 인터페이스를 빌드하는 방법을 알아보세요.
제한사항 및 알려진 문제
다음 채팅 및 부가기능은 사용할 수 없습니다.
- Apps Script의 카드 서비스 채팅 작업을 사용하고 카드를 빌드하려면 대신 JSON 객체를 반환하세요. 예는 대화형 대화상자 열기 및 링크 미리보기를 참고하세요.
- 맞춤 승인 카드 Chat에서 서비스를 인증하고 승인하려면 Chat 앱에서 기본 승인 카드를 반환해야 합니다.
- Chat 사이드바의 부가기능 홈페이지 부가기능에 홈페이지 트리거를 구성한 경우 홈페이지는 부가기능이 확장하는 다른 Google Workspace 애플리케이션의 사이드바에만 표시됩니다.
- Chat 앱 홈페이지: Chat 앱의 채팅 메시지 홈 탭에 표시됩니다.
기존 Google Workspace 부가기능을 업데이트하는 경우 Chat 앱의 다음 구성 요구사항을 고려하세요.
- Google Workspace Marketplace 설치 설정에서 개인과 Google Workspace 관리자 모두 부가기능을 설치하도록 허용해야 합니다.
- 부가기능의 manifest(
addons.common)에 있는 모든 공통 구성 설정은 Chat에서 무시됩니다. Chat에서 작동하도록 부가기능을 구성하려면 Chat API를 사용 설정하고 구성해야 합니다. 단계는 Google Chat 앱 구성을 참고하세요. - HTTP 서비스로 빌드하는 경우 Google Workspace Add-ons API를 사용 설정해야 합니다. REST 리소스
deployment및project는 다른 Google Workspace 애플리케이션의 부가기능 배포에만 적용됩니다. - Chat에서 부가기능을 배포하고 테스트하려면 Chat API의 공개 상태 설정을 사용해야 합니다. Google Workspace Marketplace SDK에서 구성한 모든 공개 상태 또는 테스트 설정은 무시됩니다. Chat에서 부가기능의 테스트 버전을 배포하려면 Chat API 문서의 Google Chat 앱의 대화형 기능 테스트를 참고하세요.
- 부가기능이 Google Workspace Marketplace에 게시된 경우 Google Chat API 구성 설정 변경사항의 초안을 저장할 수 없습니다. Chat API 구성 설정을 업데이트하면 업데이트된 Chat 앱을 모든 기존 사용자가 즉시 사용할 수 있습니다. 마켓플레이스 등록정보를 업데이트하려면 변경사항을 제출하기 전에 초안을 작성할 수 있습니다.