Gmail 작업

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은 이 응답 객체를 사용하여 임시보관 편지쓰기 창을 열고 채웁니다.

자세한 내용과 예는 임시보관 메시지 작성을 참고하세요.