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