用語集

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

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

会議プロバイダが 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 アドオンが拡張する Google Workspace アプリケーション(Gmail や Google カレンダーなど)。

HTML ベース

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

リンク プレビューは、ユーザーが Google ホスト アプリケーション(Google ドキュメントなど)内でサードパーティまたは Google 以外の URL を操作したときにトリガーされます。リンク プレビューのトリガーを使用すると、サービスまたは API からプレビューする URL パターンを定義し、スマートチップやプレビュー カードなどのプレビュー コンテンツを構成できます。リンク プレビュー トリガーはアドオン スクリプト プロジェクトのマニフェストで設定されるため、マニフェスト トリガーの一種です。

詳しくは、スマートチップを使用してリンクをプレビューするをご覧ください。

マニフェスト

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 の組み込みのカード サービスで定義された一連のウィジェット オブジェクトから作成されます。

詳しくは、ウィジェットをご覧ください。

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

特定のウィジェットを特定のアクション オブジェクトにリンクする関数。各ウィジェット タイプには、アクションへの接続に使用できる定義済みのウィジェット ハンドラ関数があります。ウィジェット ハンドラ関数は、結果のアクションをトリガーするユーザー操作の種類を定義します。これは、ウィジェットのインタラクティビティの重要なコンポーネントです。

詳細については、ウィジェット ハンドラ関数をご覧ください。