Gmail 작업

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은 이 응답 객체를 사용하여 초안 작성 창을 열고 채웁니다.

자세한 내용과 예시는 메일 초안 작성을 참고하세요.