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