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 はこのレスポンス オブジェクトを使用して下書き作成ウィンドウを開いてデータを入力します。

詳細と例については、メッセージの下書きを作成するをご覧ください。