用語集

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

カレンダー会議アドオン

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

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

カード

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

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

カードベース

ユーザー インターフェースがサイドバーにペインとして表示されるアドオン。モバイルでは、メニューから移動される別のアクティビティ ウィンドウとして表示されます。アドオンの上部には、アドオンを特定してカードを表示するツールバー(基本的にはアドオンの 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 でメールスレッドを閲覧しているが、まだ開いていない場合)。他のカードと同様に、アドオン ホームページの外観と動作を定義します。

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

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

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

HTML ベース

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

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

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

マニフェスト

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

Manifest トリガー

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

マニフェスト トリガーは Apps Script の他のトリガーとは異なります。なぜなら、マニフェスト トリガーは組み込まれていないこと(単純なトリガーなど)であり、Apps Script の Script サービスインストール可能なトリガーなど)を使用してプログラムで作成することはできません。

コンテキストに依存しないカード

ユーザーが特定のコンテキストから外れているときにコンテンツを表示するカード(Gmail でメールスレッドを表示しているが、まだ開いていない場合など)。ホームページは、コンテキストに依存しないカードの一種です。

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

スマートチップ

スマートチップとは、Google Workspace アプリケーション内のユーザー、ファイル、カレンダーの予定などのエンティティの名前リンクです。ユーザーがチップにカーソルを合わせると、そのファイルまたはリンクに関する追加コンテンツをプレビューすることもできます。たとえば、ユーザーが Google スライドのプレゼンテーションにチップにカーソルを合わせると、スライドのスクリーンショット、プレゼンテーションのオーナー、以前にそのプレゼンテーションを表示したかどうかが表示されます。

スマートチップを使用してサードパーティまたは Google 以外のサービスのリンクをプレビューするように、アドオンを構成できます。Google ドキュメントでリンクをプレビューするをご覧ください。

トリガー

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

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

トリガー関数

トリガーの発生に応答して実行されるプロジェクト内の Apps Script 関数。

ウィジェット

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

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

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

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

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