Google Chat アプリを作成して、 メッセージをエコーして応答します。
次の図は、アーキテクチャとメッセージング パターンを示しています。
上の図では、Apps Script を操作するユーザーが Chat アプリには、次のような情報の流れがあります。
- ユーザーが Chat 用アプリにメッセージを送信すると、 ダイレクト メッセージまたは Chat スペースで作成できます。
- Chat 用アプリのロジックは、 Google Cloud にある Apps Script は、 メッセージを処理します
- 必要に応じて、Chat 用アプリのロジックを Google Workspace サービス(Google カレンダーや スプレッドシート、またはその他の Google サービス(Google マップなど) YouTube で管理できます。
- Chat アプリのロジックは、 Chat での Chat アプリサービス。
- レスポンスがユーザーに送信されます。
目標
- 環境を設定する。
- スクリプトを設定します。
- Chat アプリを公開します。
- Chat アプリをテストします。
前提条件
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。
- Google Cloud プロジェクト 作成方法については、以下をご覧ください。 Google Cloud プロジェクトを作成します。
環境の設定
Google Cloud コンソールで Cloud プロジェクトを開く
まだ開いていない場合は、使用する Cloud プロジェクトを開きます。 次のように設定します。
- Google Cloud コンソールで、[プロジェクトの選択] ページに移動します。
- 使用する Google Cloud プロジェクトを選択します。または、[プロジェクトを作成] をクリックし、画面の指示に従います。Google Cloud プロジェクトを作成する場合、プロジェクトの課金を有効にする必要があります。
Chat API を有効にする
Google API を使用する前に、Google Cloud プロジェクトで有効にする必要があります。 1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。Google Cloud コンソールで、Google Chat API を有効にします。
OAuth 同意画面を構成する
OAuth 2.0 を使用するすべてのアプリには、同意画面の設定が必要です。構成 アプリの OAuth 同意画面で、ユーザーとアプリに表示される内容が定義されます 審査担当者がアプリを登録し、後で公開できるようにします。
- Google Cloud コンソールで、メニュー > API とサービス > OAuth 同意画面。 に移動します。
- [ユーザーの種類] で [内部] を選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して次へ] をクリックします。
現時点では、スコープの追加をスキップして [保存して次へ] をクリックします。 今後、Google Play 以外で使用するアプリを作成した場合、 [ユーザーの種類] を [外部] に変更してから、 アプリに必要な認可スコープを追加します。
- アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリが 問題がなければ、[ダッシュボードに戻る] をクリックします。
スクリプトを設定する
スクリプトを設定するには、テンプレートを使って Google Cloud プロジェクトを作成します。
テンプレートからスクリプトを作成する
- [ Apps Script のスタートガイド ページ。
- [Chat App] テンプレートをクリックします。必要に応じて 見てみましょう。
- [無題のプロジェクト] をクリックして「
Quickstart app
」と入力し、 [名前を変更] をクリックします。
Cloud プロジェクト番号をコピーする
- Google Cloud コンソールで、メニュー > IAM と管理 > [設定] をタップします。 に移動します。
- [プロジェクト番号] フィールドに値をコピーします。
Apps Script プロジェクトの Cloud プロジェクトを設定する
- Chat 用アプリの Apps Script プロジェクトで、
[プロジェクトの設定]
をクリックします。
- [Google Cloud Platform(GCP)プロジェクト] で、[プロジェクトを変更] をクリックします。
- [GCP プロジェクト番号] に、Google Cloud プロジェクト番号を貼り付けます。
- [プロジェクトを設定] をクリックします。
これで、試せるアプリコードが準備できました( 確認してから、要件に合わせてカスタマイズします。
Google Chat を開く際に、正しい Google アカウントにログインしていることを確認してください Apps Script テンプレート。現在のアカウントは、 自動的にデフォルトのアカウントに移行されます。
テストデプロイを作成する
この Apps Script プロジェクトのデプロイメント ID が必要です。これにより、 次のステップで使用できます。
ヘッド デプロイ ID を取得する手順は次のとおりです。
- Chat 用アプリの Apps Script プロジェクトで、 [デプロイ] をクリックします。 > [デプロイをテスト] をクリックします。
- 後のステップで使用するためにヘッド デプロイ ID をコピーし、[完了] をクリックします。
Chat アプリを公開する
Google Cloud コンソールから Chat 用アプリを公開します。
-
Google Cloud コンソール
「
Google Chat API
」を検索して [Google Chat API] をクリックします。 - [管理] をクリックします。
[Configuration] をクリックして、Chat 用アプリを設定します。
- [App name] フィールドに「
Quickstart app
」と入力します。 - [アバターの URL] フィールドに、次のように入力します。
https://developers.google.com/chat/images/quickstart-app-avatar.png
。 - [説明] フィールドに「
Quickstart app
」と入力します。 - [機能] で [1:1 のメッセージを受信する] を選択し、 スペースやグループの会話に参加する
- [接続設定] で [Apps Script プロジェクト] を選択します。
- [Deployment ID] フィールドに、先ほど作成したヘッドデプロイ ID を貼り付けます。 使用します。
- [公開設定] で [組織内の特定のユーザーとグループ ドメイン] を選択し、メールアドレスを入力します。
- [App name] フィールドに「
[保存] をクリックします。
Chat アプリでメッセージに応答できるようになりました。
Chat アプリをテストする
Chat 用アプリをテストするには、スペースを開いてダイレクト メッセージ スペースを開き、 メッセージを送信します。
Google Workspace アカウントを持つユーザーを ご自身で Trusted Tester として追加した際に提供される通知もあわせてご確認ください。
- [ チャットを新規作成] をクリックします。
- [1 人以上のユーザーを追加] フィールドに、招待する Chat アプリ。
結果から Chat 用アプリを選択します。ダイレクト というメッセージが開きます。
アプリとの新しいダイレクト メッセージで、「
Hello
」と入力し、enter
キーを押します。Chat アプリが追加に対する感謝とエコー できます。
Trusted Tester を追加し、インタラクティブ機能のテストについて詳しくは、以下をご覧ください。 インタラクティブ機能のテスト Google Chat アプリ。
トラブルシューティング
Google Chat アプリまたは card がエラーを返した場合、 Chat のインターフェースに「エラーが発生しました」というメッセージが表示されている。 または「リクエストを処理できません」が表示されます。場合によっては、Chat の UI が エラー メッセージは表示されませんが、Chat 用アプリまたは 予期しない結果が生じた場合たとえば、カード メッセージに 表示されます。
Chat UI にエラー メッセージが表示されない場合がありますが、 エラーの修正に役立つ、わかりやすいエラー メッセージとログデータ Chat 用アプリのエラーロギングが有効になっている場合。表示のヘルプについては、 エラーの修正について詳しくは、このモジュールの Google Chat のエラーのトラブルシューティングと修正
クリーンアップ
サービス アカウントに対する Google Cloud アカウントへの課金を回避するために、 リソースがある場合は、その Terraform 構成ファイルを できます。
-
Google Cloud コンソールで、[リソースの管理] ページに移動します。[
メニュー > IAM と管理者
> [リソースの管理] をクリックします。
<ph type="x-smartling-placeholder"></ph> Resource Manager に移動
- プロジェクト リストで、削除するプロジェクトを選択し、[ を削除します。
- ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックして削除します。 できます。
次のステップ
- インタラクティブなカードを作成する - カード メッセージは、定義されたレイアウト、ボタンなどのインタラクティブな UI 要素、 画像などのリッチメディアですカードメッセージを使って詳細情報を表示する ユーザーから情報を収集し、ユーザーが次のステップに進めるよう誘導する。
- スラッシュ コマンドのサポート - スラッシュ コマンドを使用すると、
ユーザーがアプリで使用できるコマンドを登録してアドバタイズする
スラッシュ(
/
)で始まるコマンド(例:/help
)を入力します。 - 起動ダイアログ - ダイアログはウィンドウ処理され、カードベースで行われます。 アプリがユーザーとやり取りするために開くことができるインターフェース。複数のカード 複数のステップを順番につなぐことができる プロセスを自動化できます。
- Gemini を使用して Google Chat 用アプリを構築する。 Codelab: より高度なアプリケーションを構築する準備が整いました。 Chat 用アプリですか?フィードバックを見る Codelab の Chat アプリ