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