Google Workspace アドオンのトリガー

Apps Script トリガーは、指定されたスクリプトを実行します。 トリガー関数（トリガー関数）を使用して、 発生します。特定のイベントのみがトリガーを発動し、 Google Workspace アプリケーションでは、別のイベントセットがサポートされています。

トリガーが発動すると、イベント オブジェクトが作成されます。この JSON 構造は には発生したイベントの詳細が含まれます。イベントの情報 オブジェクト構造は、トリガーのタイプに応じて異なる構成になっています。

イベント オブジェクトが作成されると、Apps Script はそれをパラメータとして 使用します。トリガー関数はコールバック関数であり、 問題に対処するために適切な行動を起こすよう イベントです。たとえば、 Google Workspace アドオンを使用して ユーザーがメッセージを開いたときに新しいカード インターフェースを作成するトリガーを定義する 使用します。ここでは、コンテキストに応じたコールバック関数を実装して、 渡されたデータを使用して新しい UI を構成するカード イベント オブジェクト。

このページでは、Google Cloud でトリガーを使用する際の Google Workspace できます。

マニフェスト トリガー

エディタのアドオンとは異なり、 現在 Apps Script のシンプルなトリガーを使用できない 代わりに、専用設計のトリガーを使用します。 Google Workspace アドオン: マニフェスト トリガー。

マニフェスト トリガーは完全に Google Workspace アドオンの マニフェストをご覧ください。マニフェスト トリガーの例としては、 次のとおりです。

• ホームページ トリガー: アドオンのホームページを構築して表示します。
• Calendar eventOpen トリガー新しいカードを表示したり、 その他のアクションも追加できます。
• カレンダーの eventUpdate トリガー: 新しいカードを表示する、または ユーザーがカレンダーの予定を編集、保存したときに表示されるその他のアクション。
• ドライブの onItemsSelected トリガー: 新しいカードを表示するか、 ユーザーがドライブ内のファイルやフォルダを選択したとき。
• Gmail の作成トリガー: 次のときにアドオンカードを表示します。 ユーザーが Gmail の作成ウィンドウでアドオンを開きます。
• Gmail のコンテキスト トリガー: 新しいカードの表示や、 ユーザーが Gmail のメールを開いたときの動作。
• Editor onFileScopeGranted トリガー（ユーザーが新しいカードを表示したとき） 現在のエディタで drive.file OAuth スコープの承認を付与します。 ドキュメントをご覧ください。

上記のリストでは、コンテキストを意識しないのはホームページ トリガーのみです。残りは 使用されます。マニフェストをご覧ください。 をご覧ください。

Google Workspace では、マニフェスト トリガーに加えて Apps Script を使用して インストール可能なトリガー。

制限事項

マニフェスト トリガーの使用には一定の制限があります。

• これらのトリガーは Google Workspace アドオン プロジェクトでのみ使用されます。他のアプリケーションでは使用しません。
• これらはアドオン マニフェストで定義され、コードでは定義されないため、 Apps Script を使用する Script サービスを使用してこれらのトリガーを作成または変更します。
• 現在のところ、Gmail のコンテキスト トリガーで指定できる条件は unconditional のみです。 つまり、コンテキストに応じたトリガーはメールの種類に関係なく 説明します。
• 各アドオンには、ユーザーごと、ドキュメントごとに、各タイプのトリガーを 1 つだけ設定できます。