このドキュメントでは、次の用語を使用します。
カレンダー会議アドオン
会議プロバイダが Google カレンダーの予定で会議オプションを提示できるようにする特別なアドオンです。これらのアドオンが接続するには、適切に開発された会議ソリューションが必要です。このため、ほとんどのデベロッパーは、カレンダー会議アドオンを作成する必要はありません。
詳しくは、カレンダー会議アドオンをご覧ください。カレンダー会議アドオンを Google Workspace アドオンに変換する方法については、公開済みアドオンのアップグレードをご覧ください。
カード
アドオン 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 アドオンに変換する方法については、公開済みアドオンのアップグレードをご覧ください。
ホームページ
アドオンのルート UI カード。ホームページは、ユーザーがアドオンを開いたときに表示され、特定のコンテキスト以外のコンテンツ(たとえば、ユーザーが Gmail でメールスレッドを表示しているものの、まだ開いていない)を表示できるようになります。アドオンのホームページの外観と動作は、他のカードと同様に定義します。
詳しくは、ホームページをご覧ください。
ホスト アプリケーションまたはホスト アプリケーション
Google Workspace アプリケーション(Gmail や Google カレンダーなどの Google Workspace アドオン)
HTML ベース
Apps Script の組み込みカードサービスではなく、HTML と CSS を使用してユーザー インターフェースが定義されているアドオンです。古いエディタ アドオンのみが HTML ベースです。
リンク プレビュー トリガー
ユーザーが Google ドキュメントなどの Google ホスト アプリケーション内でサードパーティまたは Google 以外の URL を操作すると、リンク プレビューのトリガーが発生します。リンク プレビュー トリガーを使用すると、サービスや API からプレビューする URL パターンを定義し、スマートチップやプレビュー カードなどのプレビュー コンテンツを構成できます。リンク プレビュー トリガーは、アドオン スクリプト プロジェクトのマニフェストで構成されているため、マニフェスト トリガーの一種です。
詳しくは、Google ドキュメントのプレビュー リンクをご覧ください。
マニフェスト
Apps Script プロジェクトに添付された JSON ファイル。マニフェストは、スクリプトを正しく実行するために必要なプロジェクト情報を定義するために使用されます。Google Workspace アドオンの場合、マニフェストを使用して、アドオンを拡張できるホストを指定し、特定の UI 制御設定を提供します。
マニフェスト トリガー
ホームページ トリガーやコンテキスト トリガーなど、プロジェクトのマニフェストで定義されているトリガー。マニフェスト トリガーは、アドオンのホームページがリクエストされたとき、またはディスプレイの更新が必要なコンテキストに入ったときに、新しいカードを作成して表示するためにのみ使用されます。
マニフェスト トリガーは、組み込みのスクリプト(単純なトリガーなど)ではなく、Apps Script のスクリプト サービス(インストール可能なトリガーなど)を使用してプログラムで作成できないため、Apps Script の他のトリガーとは異なります。
コンテキスト以外のカード
ユーザーが特定の状況以外のときにコンテンツを表示するカード(例: Gmail でメールスレッドを表示しているが、まだ開いていない)。ホームページは、コンテキストのないカードの一種です。
サイドバー
ホスト UI の右側にあるセクション。Google Workspace アドオンの UI が表示されます。Gmail とエディタのアドオンでもサイドバーを定義できます。
スマートチップ
スマートチップとは、Google Workspace アプリケーション内のユーザー、ファイル、カレンダーの予定などのエンティティを指します。チップにカーソルを合わせると、ファイルやリンクに関する追加コンテンツをプレビューできます。たとえば、チップを Google スライドのプレゼンテーションにカーソルを合わせると、スライドのスクリーンショット、プレゼンテーションのオーナー、以前にプレゼンテーションを閲覧したかどうかが表示されます。
スマートチップを使用して、サードパーティまたは Google 以外のサービスのリンクをプレビューするようにアドオンを構成できます。Google ドキュメントでリンクをプレビューするをご覧ください。
トリガー
Apps Script プロジェクトまたはアドオンで定義された条件と自動イベント レスポンス。トリガーは、関連するイベント(アドオンが開いたときなど)が発生すると起動し、指定された Apps Script 関数(トリガー関数)を自動的に実行します。Google Workspace アドオンの場合、表示される UI のアドオン部分を制御するために、トリガー関数によって新しいカードが作成されることがよくあります。特定のイベントタイプでのみトリガーを設定できます。
詳細については、アドオン トリガーをご覧ください。
トリガー関数
トリガーの発生に応じて実行されるプロジェクトの Apps Script 関数。
ウィジェット
ボタン、テキスト フィールド、チェックボックスなどの UI 要素。カードは、Apps Script の組み込みカードサービスによって定義される一連のウィジェット オブジェクトから構築されます。
詳しくは、ウィジェットをご覧ください。
ウィジェット ハンドラ関数
特定のウィジェットを特定のアクション オブジェクトにリンクする関数。各ウィジェット タイプには、アクションへの接続に使用できる一連のウィジェット ウィジェット ハンドラ関数が含まれています。ウィジェット ハンダー関数は、どのようなアクションがユーザー インタラクションによって生成されるアクションをトリガーするかを定義するもので、ウィジェットのインタラクティビティの重要なコンポーネントです。
詳細については、ウィジェット ハンドラ関数をご覧ください。