コーディング レベル: 中級
所要時間: 25 分
プロジェクトの種類: Google Chat アプリ
目標
- ソリューションの機能を理解します。
- Apps Script サービスがソリューション内でどのように機能するかを理解します。
- 環境を設定する。
- スクリプトを設定します。
- スクリプトを実行します。
このソリューションについて
ダイレクト メッセージ(DM)または Google Chat のスペースから Google カレンダーで会議をスケジュールする。件名、開始時間、時間など、会議の特定の詳細情報を設定できます。また、会議のインスタント スケジューリングのデフォルト設定を使用することもできます。
仕組み
Chat アプリのスクリプトは、スラッシュ コマンドとダイアログを使用して、ユーザーから会議の詳細を取得し、カレンダーの予定をスケジュールします。このスクリプトにはデフォルトの会議設定が含まれており、必要に応じてカスタマイズできます。
Apps Script サービス
このソリューションでは、次のサービスを使用します。
- カレンダー サービス - 指定された会議情報からカレンダーの予定を作成します。
- 基本サービス -
Session
クラスを使用して、スクリプトのタイムゾーンを取得します。予定のスケジュールを設定する際は、このタイムゾーンが使用されます。 - ユーティリティ サービス - カレンダー イベントの日付を書式設定し、イベント URL を取得できるようにイベント ID をエンコードします。
前提条件
このサンプルを使用するには、次の前提条件を満たす必要があります。
- Google アカウント(Google Workspace アカウントの場合、管理者の承認が必要になる場合があります)。
- インターネットにアクセスできるウェブブラウザ。
- Google Cloud プロジェクト。
環境を設定する
Google Cloud コンソールで Cloud プロジェクトを開く
まだ開いていない場合は、このサンプルで使用する Cloud プロジェクトを開きます。
- Google Cloud コンソールで [プロジェクトの選択] ページに移動します。
- 使用する Google Cloud プロジェクトを選択します。または、[プロジェクトを作成] をクリックし、画面の指示に従います。Google Cloud プロジェクトを作成する場合は、プロジェクトの課金を有効にすることが必要な場合があります。
API を有効にする
Google API を使用する前に、Google Cloud プロジェクトで API を有効にする必要があります。1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。Cloud プロジェクトで、Google Chat API を有効にします。
OAuth 同意画面を構成する
すべての Chat アプリでは、同意画面の構成が必要です。アプリの OAuth 同意画面を構成すると、Google がユーザーに表示する内容を定義し、後で公開できるようにアプリを登録します。
- Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。
- [ユーザーの種類] で [内部] を選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して次へ] をクリックします。
現時点では、スコープの追加をスキップして、[Save and Continue] をクリックします。今後、Google Workspace 組織外で使用するアプリを作成する場合は、[ユーザータイプ] を [外部] に変更してから、アプリに必要な認証スコープを追加する必要があります。
- アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリ登録に問題がない場合は、[Back to Dashboard] をクリックします。
スクリプトを設定する
Apps Script プロジェクトを作成する
- 次のボタンをクリックして、[Schedule meeting from Google Chat] Apps Script プロジェクトを開きます。
プロジェクトを開く - [概要] をクリックします。
- 概要ページで、コピーを作成 をクリックします。
Cloud プロジェクト番号をコピーする
- Google Cloud コンソールで、メニュー > [IAM と管理] > [設定] に移動します。
- [プロジェクト番号] フィールドで、値をコピーします。
Apps Script プロジェクトの Cloud プロジェクトを設定する
- コピーした Apps Script プロジェクトで、[プロジェクトの設定] をクリックします。
- [Google Cloud Platform(GCP)プロジェクト] で、[プロジェクトを変更] をクリックします。
- [GCP のプロジェクト番号] に、Google Cloud のプロジェクト番号を貼り付けます。
- [プロジェクトを設定] をクリックします。
テストデプロイを作成する
- コピーした Apps Script プロジェクトで、[デプロイ] > [デプロイをテスト] をクリックします。
- 後のステップで使用するためにヘッド デプロイ ID をコピーし、[完了] をクリックします。
Chat API を構成する
- Google Cloud コンソールで [Chat API] ページに移動します。
Chat API に移動 - [構成] をクリックします。
- 次の情報を使用して Chat API を構成します。
- 名前:
Meeting Scheduler
- アバター URL: 最小サイズが 256x256 ピクセルの画像を指す URL を追加します。
- 説明:
Quickly create meetings.
- 機能: 両方のチェックボックスをオンにして、ユーザーがアプリに直接メッセージを送信してスペースに追加できるようにします。
- 接続設定: [Apps Script] をクリックして、ヘッドデプロイ ID を入力します。
- スラッシュ コマンド:
/help
と/schedule_Meeting
のスラッシュ コマンドを追加します。手順は次のとおりです。- [スラッシュ コマンドを追加] をクリックし、次の情報を使用して構成します。
- 名前:
/help
- コマンド ID:
1
- 説明:
Learn what this app does.
- 名前:
- もう一度 [スラッシュ コマンドを追加] をクリックし、次の情報を使用して構成します。
- 名前:
/schedule_Meeting
- コマンド ID:
2
- 説明:
Schedule a meeting.
- [ダイアログを開く] チェックボックスをオンにします。
- 名前:
- [スラッシュ コマンドを追加] をクリックし、次の情報を使用して構成します。
- 権限: [ドメイン内の特定のユーザーとグループ] を選択し、メールアドレスを入力します。
- 名前:
- [保存] をクリックしてページを更新します。
- 構成ページの [アプリのステータス] で、ステータスを [公開 - ユーザーが利用可能] に設定します。
- [保存] をクリックします。
スクリプトを実行する
- Google Chatを開きます。
- 「チャットを開始」アイコン をクリックします。
- アプリの名前(
Meeting Scheduler
)を検索します。 - 最初のメッセージ(
hello
など)を送信して承認を促します。 アプリから応答したら、[設定] をクリックしてアプリを承認します。OAuth 同意画面に「このアプリは確認されていません」という警告が表示された場合は、[詳細設定] > [{プロジェクト名}(安全でない)に移動] を選択します。
/schedule_Meeting
をアプリに送信します。ダイアログで、招待するユーザーのメールアドレスを 1 つ以上追加します。他のフィールドを更新するか、デフォルトのエントリを使用できます。
[送信] をクリックします。
会議を表示するには、[カレンダーの予定を開く] をクリックします。
コードを確認する
このソリューションの Apps Script コードを確認するには、下の [ソースコードを表示] をクリックします。
ソースコードを表示
Code.gs
Dialog.gs
Utilities.gs
協力者
このサンプルは、Google Developer Experts の協力により Google が保守しています。