Google カレンダーのサードパーティの会議ソリューションを提供する Google Workspace アドオンを構築する手順は、Google Workspace アドオンの構築手順と基本的に同じですが、いくつかの追加手順があります(以下の太字で示しています)。
- アドオンのプロジェクト オーナーと共同編集者を選択します。
- Apps Script プロジェクトを作成する。
- アドオンの外観と動作をデザインします。
- カレンダー拡張サービスを有効にします。
- アドオン プロジェクト マニフェストを構成します。
- Apps Script 組み込みのカードサービスを使用して、アドオンの外観と動作を定義するコードを記述します。
- Apps Script の組み込み
ConferenceData
サービスを使用して、会議ソリューションを管理するコードを 記述します。 - (省略可)アドオン設定ページを作成して設定する。
- Apps Script の組み込み
- アドオンの OAuth スコープを確認します。
- 拡張するホストアプリケーション内でアドオンをテストします。
- アドオンを公開します。
このページでは、新しい各ステップの概要について説明します(他のステップの概要については、Google Workspace アドオンの構築をご覧ください)。
カレンダー拡張サービスを有効にする
Calendar の高度なサービスを使用すると、Apps Script プロジェクトから Calendar API を直接呼び出すことができます。カレンダーの予定の同期などの一部の一般的なオペレーションは、拡張サービスの使用でのみ実行できます。拡張サービスを使用するには、アドオン プロジェクトで拡張サービスを有効にする必要があります。
Apps Script エディタから Calendar Advanced Service を有効にすることができます。エディタの [Google の拡張サービス] ダイアログと Google API コンソールの両方で API を有効にしてください。
マニフェストで会議ソリューションを定義する
アドオン マニフェストは、Google カレンダーが会議アドオンのソリューションを正しく表示して有効にするために必要な基本情報を提供します。アドオン マニフェストでは、Google カレンダーの予定で使用できるサードパーティの会議の種類を記述した会議ソリューションを(calendar
セクションで)定義する必要があります。
アドオンのマニフェストを構成する方法については、マニフェストをご覧ください。
会議を作成して同期するためのコードを追加する
スクリプト プロジェクトを作成したら、コードを追加してアドオンの会議関連の動作を定義できます。Calendar Advanced Service、ConferenceData サービス、その他の Apps Script サービスを使用して、この動作を制御できます。
アドオンに会議処理コードを追加するときに、会議の作成、カレンダーの変更内容の同期、必要に応じて設定ページの追加を行うコードを追加する必要があります。
アドオンのユーザー エクスペリエンスを設計する方法のガイドラインについては、コーディングの際にアドオン スタイルガイドをご覧ください。
会議を作成する
アドオンでは、Google カレンダーの予定に関する情報を取得し、それを使用してサードパーティの会議システムで会議を作成できる必要があります。このプロセスを実行する 1 つ以上の onCreateFunction
メソッドを実装し、アドオン マニフェストでこれらのメソッドを構成する必要があります。
詳細については、サードパーティの会議を作成するをご覧ください。
カレンダーの変更を同期する
会議を作成して Google カレンダーの予定にリンクしたら、変更を反映するために会議の更新が必要になることがよくあります。たとえば、ユーザーがイベントの時刻を変更した場合は、それを反映するようにサードパーティの会議システムの会議データを更新する必要があります。イベントの変更に応じて会議データを更新するプロセスを「同期」と呼びます。
詳しくは、カレンダーの変更を同期するをご覧ください。
設定を追加する
ユーザーがアドオンを設定できるように、オプションの設定が必要になる場合があります。 たとえば、ユーザーが会議パラメータや会議に添付されたメモを設定できるようにする必要があるとします。
ユーザーがアドオンの動作をある程度制御する必要がある場合は、アドオン設定ページでそれらのオプションを指定できます。このウェブページは、ユーザーが Google カレンダー UI 内のアドオン設定にアクセスしたときに開きます(アドオン スクリプトでホストされているか、外部でホストされている)。
アドオン設定ページの作成は任意です。詳細については、設定を追加するをご覧ください。