会議ソリューションを追加する Google Workspace アドオンには、アドオンの 設定ページからユーザーが制御する必要がある詳細情報が含まれていることがよくあります。たとえば、ユーザーがサードパーティの会議システムからログアウトするためのボタンやコントロールが用意されているのが一般的です。
アドオンの設定ページは省略可能です。以降のセクションでは、アドオンの設定ページを開く方法と、設定ページを作成する方法について説明します。
アドオンの設定を開く
会議アドオンの設定には、カレンダーの設定メニューからアクセスできます。インストールしたアドオンの設定ページを開く手順は次のとおりです。
- Google カレンダーを開きます。
- アイコンをクリックし、 [Settings] を選択します。
- 左側のナビゲーション パネルで [アドオン] を選択して、インストール済みアドオンのリストに移動します。
- アドオン名の右側に表示される [設定] ボタンをクリックすると、そのアドオンの設定ページが開きます。これにより、カレンダーで設定ページの URL が開きます。
アドオンで設定ページが定義されていない場合、[設定] ボタンは表示されません。
設定ページを作成する
設定ページは、標準の HTML と CSS を使用して作成します。ページを設計する際は、 次の アドオンのスタイルガイドラインに従ってください。
ユーザーがアドオンの設定を調整すると、ページはサードパーティの会議システムに変更を反映させるリクエストを送信する必要があります。 また、必要に応じて、アドオン プロジェクトの ユーザー プロパティ から情報を保存したり取得したりすることもできます。
外部ウェブサーバーでホストされている
アドオンの設定ページは、アドオン スクリプト プロジェクトの外部でホストできます。たとえば、サードパーティの会議ウェブサイトの一部としてホストできます。
アドオンを外部の設定ページにリンクする手順は次のとおりです。
- ページを作成し、外部でホストします。ページに要素を追加する際は、サードパーティの会議システムと正しく通信し、そのユーザーに適した変更を加えるようにしてください。
- アドオン スクリプト プロジェクトで、外部ページの URL を返す関数を実装します。
- この関数の名前を、アドオン プロジェクト
マニフェストの
calendar.createSettingsFunctionフィールドとして指定します。
Apps Script 内でホストされている
Apps Script ウェブアプリを使用して、アドオンの設定ページを提供できます。ウェブアプリとして、アドオン スクリプト プロジェクトでページを作成してデプロイし、Apps Script サーバーでホストできます。
ウェブアプリ用の HTML の作成方法について詳しくは、HTML Service ガイド をご覧ください。設定ページは 必要に応じて Google サーバーと 通信できます。また、ページで テンプレートを使用して、ページをより 動的にすることもできます。
カレンダー会議アドオンの例 では、ウェブアプリの設定ページを作成する方法を示しています。