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