Action 객체를 사용하면 Google Workspace 부가기능에 대화형 동작을 빌드할 수 있습니다. 이는 사용자가 부가기능 UI에서 위젯 (예: 버튼)과 상호작용할 때 발생하는 작업을 정의합니다.
작업은 위젯 핸들러 함수를 사용하여 지정된 위젯에 연결되며, 이 함수는 작업을 트리거하는 조건도 정의합니다. 트리거되면 작업은 지정된 콜백 함수를 실행합니다. 콜백 함수에는 사용자의 클라이언트 측 상호작용에 관한 정보를 전달하는 이벤트 객체가 전달됩니다. 콜백 함수를 구현하고 특정 응답 객체를 반환하도록 해야 합니다.
예를 들어 클릭 시 새 카드를 빌드하고 표시하는 버튼을 만들고 싶다고 가정해 보겠습니다. 이렇게 하려면 새 버튼 위젯을 만들고 버튼 위젯 핸들러 함수 setOnClickAction(action)를 사용하여 카드 작성 Action을 설정해야 합니다. 정의하는 Action는 버튼이 클릭될 때 실행되는 Apps Script 콜백 함수를 지정합니다. 이 경우 콜백 함수를 구현하여 원하는 카드를 빌드하고 ActionResponse 객체를 반환합니다. 응답 객체는 부가기능에 콜백 함수가 빌드한 카드를 표시하도록 지시합니다.
이 페이지에서는 부가기능에 포함할 수 있는 Gmail용 위젯 작업을 설명합니다.
Gmail 상호작용
Gmail을 확장하는 Google Workspace 부가기능에는 Gmail용 위젯 작업을 추가하여 메일 초안을 작성할 수 있습니다. 이 작업을 사용하려면 연결된 작업 콜백 함수가 특수화된 응답 객체를 반환해야 합니다.
| 시도된 작업 | 콜백 함수는 다음을 반환해야 합니다. |
|---|---|
| 메시지 초안 작성 | ComposeActionResponse |
이러한 위젯 작업과 응답 객체를 사용하려면 부가기능이 매니페스트에 https://www.googleapis.com/auth/gmail.addons.current.action.compose
범위를 포함해야 합니다.
메시지 작성
Gmail을 확장하는 Google Workspace 부가기능은 상호작용할 때 Gmail에서 메시지 초안(새 메시지 또는 답장)을 생성하는 위젯을 정의할 수 있습니다. 이렇게 하려면 트리거 위젯을 ComposeActionResponse 객체를 반환하는 콜백 함수와 연결해야 합니다. 콜백 함수 실행이 완료되면 Gmail은 이 응답 객체를 사용하여 임시보관 메일 작성 창을 열고 채웁니다.
자세한 내용과 예시는 메시지 초안 작성을 참고하세요.