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