用語集

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このドキュメントでは、次の用語を使用しています。

カレンダー会議のアドオン

特殊なアドオンによって、会議プロバイダが Google カレンダーの予定に会議オプションを表示できるようにします。これらのアドオンが接続するには、十分に開発された会議ソリューションが必要です。このため、ほとんどのデベロッパーは、カレンダー会議アドオンを作成する必要はありません。

詳しくは、カレンダー会議アドオンをご覧ください。カレンダーの会議アドオンを Google Workspace アドオンに変換する方法については、公開済みのアドオンをアップグレードするをご覧ください。

Card

アドオン UI の単一の「ページ」。カードはさまざまなウィジェット オブジェクト(ボタン、テキスト フィールド、ヘッダーなど)で構成されています。

詳しくは、カードをご覧ください。

カード形式

ユーザー インターフェースがサイドバーにペインとして表示されるアドオン(モバイルでは、メニューを介して表示される別のアクティビティ ウィンドウ)。アドオンには、アドオンを識別してカード(上部にはアドオンの UI の基本的に「ページ」)が表示される上部のツールバーがあります。

Google Workspace アドオンはカード形式です。

会議データ

Google Workspace アドオンまたはカレンダー会議アドオンによって有効になっているサードパーティの会議をユーザーが作成、参加するために Google カレンダーで必要となる情報のセット。

詳細については、会議データをご覧ください。

会議ソリューション

Google Workspace アドオンまたはカレンダー会議アドオンを使用して Google カレンダーから作成されるサードパーティ会議のリスト。

詳細については、会議ソリューションをご覧ください。

コンテキスト

ホスト アプリケーションの現在の状態。たとえば、現在 Gmail で開いているメッセージ、編集中のカレンダー イベント、選択したドライブ ファイルなどが、ホスト アプリケーションの現在のコンテキストの一部になります。コンテキストは、他の情報とともにイベント オブジェクトに収集され、トリガー関数でパラメータとして渡されます。

コンテキストに応じたトリガー

Gmail でメールスレッドを開いたときなど、ユーザーが特定のコンテキストを入力したときに起動するトリガーを定義します。コンテキスト トリガーを使用すると、アドオンはそのコンテキストに関連する UI を提供できます。コンテキスト トリガーは、アドオン スクリプト プロジェクトのマニフェストで構成されるため、マニフェスト トリガーの一種です。

エディタのアドオン

Google ドキュメント、スプレッドシート、フォーム、スライドの拡張機能のみを許可していた元のアドオンの種類エディタ アドオンはカード形式ではなく、未加工の HTML と CSS から開発者が UI を作成することを必要としていました。各エディタ アドオンで拡張できるホスト アプリケーションは 1 つのみです。

詳しくは、エディタのアドオンをご覧ください。

イベント オブジェクト

ホームページがリクエストされたとき、アドオンが応答する必要があるコンテキストに入ったとき、またはアドオン インターフェース内のウィジェットをユーザーが操作した結果として自動的に作成される JSON オブジェクト。作成された後、イベント オブジェクトは、指定したトリガー関数またはコールバック関数に渡されます。イベント オブジェクトの目的は、ユーザーのクライアント側の環境(アドオン インターフェース ウィジェットに入力した情報など)をサーバー側のコードに渡すことです。サーバーサイドのコードは、その情報を基に、適切なレスポンスを返すことができます。

詳しくは、イベント オブジェクトをご覧ください。

Gmail のアドオン

Gmail のみに拡張するアドオン。Gmail のアドオンはカード形式です。Gmail アドオンの作成に使用される機能、動作、開発の詳細の多くは、Google Workspace アドオンの作成に使用したものと同じです。

詳しくは、Gmail アドオンをご覧ください。Gmail アドオンを Google Workspace アドオンに変換する方法については、公開済みのアドオンをアップグレードするもご覧ください。

Homepage

アドオンのルート UI カード。ホームページは、ユーザーがアドオンを開いたときに表示されます。また、アドオンでは特定のコンテキストの外部でコンテンツを表示できます(ユーザーが Gmail のメールスレッドを表示しているものの、開いていない場合)。アドオンのホームページの外観と動作は、他のカードと同様に定義します。

詳しくは、ホームページをご覧ください。

ホスト アプリケーションまたはホスト アプリケーション

Gmail や Google カレンダーなどの Google Workspace アドオンが拡張する Google Workspace アプリケーション。

HTML ベース

ユーザー インターフェースが Apps Script 組み込みの Card サービスではなく HTML と CSS を使用して定義されているアドオン。古いエディタ アドオンのみが HTML ベースです。

マニフェスト

Apps Script プロジェクトに添付された JSON ファイル。マニフェストは、スクリプトを正しく実行するために必要なプロジェクト情報を定義するために使用されます。Google Workspace アドオンの場合、マニフェストを使用して、アドオンが拡張できるホストを指定し、特定の UI コントロール設定を提供します。

マニフェスト トリガー

ホームページ トリガーやコンテキスト トリガーなど、プロジェクトのマニフェストで定義されているトリガー。マニフェスト トリガーは、アドオンのホームページがリクエストされたとき、またはアドオンが表示更新を必要とするコンテキストに入ったときに、新しいカードを作成して表示するためにのみ使用されます。

マニフェスト トリガーは、組み込みスクリプト(シンプルなトリガーなど)ではなく、Apps Script スクリプト サービスインストール可能なトリガーなど)を使用してプログラムで作成できないため、Apps Script の他のトリガーとは異なります。

コンテキスト以外のカード

ユーザーが特定のコンテキスト外にいるときにコンテンツを表示するカード。たとえば、Gmail でメールスレッドを表示しているが、メールスレッドを開いていない場合など。ホームページは、コンテキストのないカードの一つです。

ホスト UI の右側のセクション。Google Workspace アドオンの UI が表示されます。Gmail とエディタのアドオンでも、サイドバーを定義できます。

トリガー

Apps Script プロジェクトまたはアドオンで定義された条件と自動イベント レスポンス。トリガーは、関連するイベント(アドオンが開いた場合など)が発生すると起動し、指定された Apps Script 関数(トリガー関数)を自動的に実行します。Google Workspace アドオンの場合、トリガー関数は通常、アドオン UI のどの部分が表示されるかを制御するために、新しいカードを作成します。特定のイベントタイプに対してのみトリガーを設定できます。

詳しくは、アドオン トリガーをご覧ください。

トリガー関数

トリガーの開始に応じて実行されるプロジェクトの Apps Script 関数。

ウィジェット

ボタン、テキスト フィールド、チェックボックスなどの UI 要素。カードは、Apps Script の組み込みカードサービスによって定義される一連のウィジェット オブジェクトから構成されます。

詳しくは、ウィジェットについての記事をご覧ください。

ウィジェット ハンドラ関数

特定のウィジェットを特定のアクション オブジェクトにリンクする関数。各ウィジェット タイプには、アクションに接続するために使用できる定義済みのウィジェット ハンドラ関数のセットがあります。ウィジェット ハンドヘルド関数は、最終的なアクションをトリガーするユーザー インタラクションの種類を定義し、ウィジェットのインタラクティビティの重要な要素です。

詳しくは、ウィジェット ハンドラの関数をご覧ください。