GSP250

概要

Google Chat bot は、組織のデータやサービスにアクセスする便利な手段として利用できます。ユーザーは、チャットを通じて bot と会話することができます。Google Chat bot を作成する方法の 1 つは、Google Apps Script を使用することです。この方法を行うと、ドライブ、Gmail、カレンダー、ドキュメント、スプレッドシートなど、他の Google サービスにも簡単にアクセスできるようになります。

このラボでは、Google Chat bot の概要を簡単に説明するために、Google Apps Script を使用してシンプルな Google Chat bot を作成します。

演習内容

このラボでは、次のタスクを行います。

• 事前に入力されたイベント ハンドラを含むテンプレートからチャットアプリを作成する。
• chat bot を構成して公開する。

設定と要件

[ラボを開始] ボタンをクリックする前に

こちらの説明をお読みください。ラボには時間制限があり、一時停止することはできません。タイマーは、Google Cloud のリソースを利用できる時間を示しており、[ラボを開始] をクリックするとスタートします。

このハンズオンラボでは、シミュレーションやデモ環境ではなく実際のクラウド環境を使って、ラボのアクティビティを行います。そのため、ラボの受講中に Google Cloud にログインおよびアクセスするための、新しい一時的な認証情報が提供されます。

このラボを完了するためには、下記が必要です。

• 標準的なインターネット ブラウザ（Chrome を推奨）

注: このラボの実行には、シークレット モード（推奨）またはシークレット ブラウジング ウィンドウを使用してください。これにより、個人アカウントと受講者アカウント間の競合を防ぎ、個人アカウントに追加料金が発生しないようにすることができます。

• ラボを完了するための時間（開始後は一時停止できません）

注: このラボでは、受講者アカウントのみを使用してください。別の Google Cloud アカウントを使用すると、そのアカウントに料金が発生する可能性があります。

ラボを開始して Google Cloud コンソールにログインする方法

1. [ラボを開始] ボタンをクリックします。ラボの料金をお支払いいただく必要がある場合は、表示されるダイアログでお支払い方法を選択してください。 左側の [ラボの詳細] ペインには、以下が表示されます。

   • [Google Cloud コンソールを開く] ボタン
   • 残り時間
   • このラボで使用する必要がある一時的な認証情報
   • このラボを行うために必要なその他の情報（ある場合）

2. [Google Cloud コンソールを開く] をクリックします（Chrome ブラウザを使用している場合は、右クリックして [シークレット ウィンドウで開く] を選択します）。

   ラボでリソースがスピンアップし、別のタブで [ログイン] ページが表示されます。

   ヒント: タブをそれぞれ別のウィンドウで開き、並べて表示しておきましょう。

   注: [アカウントの選択] ダイアログが表示されたら、[別のアカウントを使用] をクリックします。

3. 必要に応じて、下のユーザー名をコピーして、[ログイン] ダイアログに貼り付けます。

   {{{user_0.username | "Username"}}}

   [ラボの詳細] ペインでもユーザー名を確認できます。

4. [次へ] をクリックします。

5. 以下のパスワードをコピーして、[ようこそ] ダイアログに貼り付けます。

   {{{user_0.password | "Password"}}}

   [ラボの詳細] ペインでもパスワードを確認できます。

6. [次へ] をクリックします。

   重要: ラボで提供された認証情報を使用する必要があります。Google Cloud アカウントの認証情報は使用しないでください。 注: このラボでご自身の Google Cloud アカウントを使用すると、追加料金が発生する場合があります。

7. その後次のように進みます。

   • 利用規約に同意してください。
   • 一時的なアカウントなので、復元オプションや 2 要素認証プロセスは設定しないでください。
   • 無料トライアルには登録しないでください。

その後、このタブで Google Cloud コンソールが開きます。

注: Google Cloud のプロダクトやサービスにアクセスするには、ナビゲーション メニューをクリックするか、[検索] フィールドにサービス名またはプロダクト名を入力します。

タスク 1. テンプレートから Chat アプリを作成する

bot を実装するには、Chat アプリ テンプレートを使用して新しい Google Apps Script プロジェクトを作成します。

注: Google Cloud コンソールにログインすると、プロジェクトと認証情報が設定されます。ステップ 1 で Google Apps Script エディタのリンクをクリックする前に、Google Cloud コンソールにログインしていることを確認してください。

1. この Google Apps Script ホームページのリンクをクリックして、Google Apps Script オンライン エディタを開きます。

2. [Google Workspace アドオンのスターター] で、[Chat アプリ]（中級バージョン）をクリックします。

3. [無題のプロジェクト]（現在の名前）をクリックします。

4. [プロジェクト名の編集] ダイアログで、プロジェクトの名前を「Friendly Bot」に変更し、[名前を変更] をクリックします。

Google Chat のイベント

Apps Script bot と Google Chat のやり取りの多くはイベント駆動型です。ユーザー、bot、Google Chat の間のやり取りは、通常、次のような流れになります。

1. ユーザーがなにかアクションを実行します。たとえば、チャットルームに bot を追加する、bot とのダイレクト メッセージ（DM）を開始する、チャットルームから bot を削除する、などです。
2. このアクションにより、Google Chat の bot に対してイベントが発生します。
3. Google Chat は、bot のスクリプトで定義された、対応するイベント ハンドラを呼び出します。

Google Chat では、Apps Script bot がリッスンできるイベントが 4 つ発生します。

• ADDED_TO_SPACE: このイベントは、人間のユーザーがチャットルームまたは DM に bot を追加したときに発生します。このイベントを処理するために、Apps Script で onAddedToSpace() 関数を定義します。
• REMOVED_FROM_SPACE: このイベントは、ユーザーがチャットルームまたは DM から bot を削除したときに発生します。このイベントでは、Google Chat に対してレスポンスは返されません。このイベントを処理するために、Apps Script で onRemovedFromSpace() 関数を定義します。
• MESSAGE: このイベントは、ユーザーが DM で直接、またはチャットルームの @mention で bot にメッセージを送信したときに発生します。このイベントに応答するために、Apps Script で onMessage() 関数を定義します。

MESSAGE イベント ハンドラのコードを確認する

Chat アプリ テンプレートには、イベント ハンドラを含むコードファイルが事前に入力されています。

• Code.gs ファイルをクリックして、事前入力されたイベント ハンドラを確認します。

MESSAGE、ADDED_TO_SPACE、REMOVE_FROM_SPACE イベントのイベント ハンドラに注目してください。これらのハンドラは、前述の特定の関数を実行して、Google Chat でのユーザー メッセージへの応答など、さまざまなタスクを完了します。

テンプレートから Chat アプリを作成する

タスク 2. chat bot を公開してテストする

bot を実行してテストする前に、Google Cloud プロジェクトで Google Chat API を有効にし、bot を公開する必要があります。

このタスクでは、OAuth 同意画面の構成、適切な Google Cloud プロジェクトを参照するための Apps Script アプリケーションの更新、テスト用に bot を公開するための Google Chat API 構成の更新など、bot を公開するためのさまざまな構成手順を完了します。

OAuth 同意画面を構成する

1. Google Cloud コンソールで左上のナビゲーション メニュー（）をクリックして、[API とサービス] > [OAuth 同意画面] に移動します。

2. [利用開始] をクリックします。

3. [プロジェクト構成] ページの [アプリ情報] で次の構成を行い、[次へ] をクリックします。

フィールド	値
アプリ名	Friendly Bot
ユーザー サポートメール	プルダウンからメール ID を選択します。これは、ラボの手順の左側のパネルにある [ユーザーのメール] にも表示されます。

4. [対象] で [内部] を選択し、[次へ] をクリックします。

5. [連絡先情報] で、メールアドレス を入力し、[次へ] をクリックします。

6. ポリシーに同意し、[続行]、[作成] の順にクリックします。

[進行状況を確認] をクリックして、目標に沿って進んでいることを確認します。

ユーザーの同意画面を構成する

Google Cloud プロジェクト番号を特定し、それを参照するように Apps Script アプリケーションを更新する

1. ナビゲーション メニュー（）で、[Cloud の概要] > [ダッシュボード] をクリックします。

2. ダッシュボードで、[プロジェクト情報] セクションを見つけます。

3. 次のステップでプロジェクトの構成に使用するためにプロジェクト番号をメモしておきます。

4. Apps Script エディタに戻り、Friendly Bot プロジェクトの [プロジェクト設定] に移動します（）。

5. [Google Cloud Platform（GCP）プロジェクト] で、[プロジェクトを変更] をクリックします。

6. [GCP プロジェクト番号] に、先ほどコピーしたプロジェクト番号を入力します。[プロジェクトを設定] をクリックします。

chat bot を構成して公開する

1. Apps Script エディタで、画面右上の [デプロイ] > [デプロイをテスト] をクリックし、[ヘッドデプロイ ID] の横にある [コピー] をクリックして、テストデプロイのヘッドデプロイ ID を取得します。

2. Google Cloud コンソールで、ナビゲーション メニュー（） > [API とサービス] > [ライブラリ] に移動します。

3. ライブラリで「Google Chat API」を検索し、結果のリストから API を選択します。

このプロジェクトでは Google Chat API がすでに有効になっているはずです。有効になっていない場合は、[有効にする] をクリックします。

4. [管理] をクリックし、Google Chat API の [構成] タブをクリックします。

5. [構成] ダイアログの項目で次の値を設定します。

フィールド	値
アプリ名	Friendly Bot
アバターの URL	https://goo.gl/kv2ENA
説明	Apps Script lab bot
機能	[スペースとグループの会話に参加する] を有効にする
接続設定	[Apps Script] をオンにして、手順 1 でコピーしたヘッドデプロイ ID を [デプロイ ID] ボックスに貼り付けます。
公開設定

6. [保存] をクリックします。

7. 変更を保存したら、[構成] ダイアログの上部までスクロールして、[アプリのステータス] を [ライブ - ユーザーが利用可能] に更新します。

[アプリのステータス] フィールドを表示するには、ページを更新する必要がある場合があります。[アプリのステータス] の値がすでに [ライブ - ユーザーが利用可能] に設定されている場合は、その値をそのまま使用できますが、次のステップで必ずページを再度保存してください。

8. もう一度 [保存] をクリックします。

chat bot をテストする

最後のセクションでは、次の手順を完了して Google Chat で bot をテストします。

1. Google Chat のリンクをクリックして、Google Chat を開きます。

2. [チャットを開始] を選択します。

3. 「Friendly bot」を検索します。

4. 検索結果で、先ほど作成した [Friendly Bot]（Apps Script lab bot）を選択してチャットを開始します。

ダイレクト メッセージのスレッドが開き、DM への追加に対する bot からの感謝のメッセージが表示されます。

XXXXX さん、ダイレクト メッセージに私を追加してくれてありがとう！

この応答は、onAddedToSpace という名前の関数によって開始されます。この関数は、bot がチャットスペースに追加されたという特定のイベントに応答します。

5. 最後に、bot へのメッセージを入力します（例: 「Hello bot!」）。

bot から、次のようなメッセージが表示されるはずです。

「Hello bot!」と入力しました。

この応答は、onMessage という名前の関数によって開始されます。この関数は、ユーザーが bot にダイレクト メッセージを送信するという特定のイベントに応答します。

お疲れさまでした

ユーザーのメッセージに返信する Google Chat bot を短時間で作成できました。

次のステップと詳細情報

• Workspace で他にできることを確認する:
  • Google Apps Script: コード 4 行で Google スプレッドシート、Google マップ、Gmail にアクセスする
• 以下の便利なリソースもお役立てください。
  • Google Chat ドキュメント サイト
  • Apps Script bot のクイックスタート
  • 新しい bot を作成する
  • bot を公開する
  • インタラクティブなカードを作成する
  • カードに関するページ
  • イベント オブジェクトに関するページ
  • Gmail Advanced Service に関するページ
  • Calendar Apps Script API に関するページ
  • Google Workspace ラーニング センター

Google Cloud トレーニングと認定資格

Google Cloud トレーニングと認定資格を通して、Google Cloud 技術を最大限に活用できるようになります。必要な技術スキルとベスト プラクティスについて取り扱うクラスでは、学習を継続的に進めることができます。トレーニングは基礎レベルから上級レベルまであり、オンデマンド、ライブ、バーチャル参加など、多忙なスケジュールにも対応できるオプションが用意されています。認定資格を取得することで、Google Cloud テクノロジーに関するスキルと知識を証明できます。

マニュアルの最終更新日: 2025 年 8 月 18 日

ラボの最終テスト日: 2025 年 8 月 18 日

Copyright 2025 Google LLC. All rights reserved. Google および Google のロゴは Google LLC の商標です。その他すべての企業名および商品名はそれぞれ各社の商標または登録商標です。