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 Chat にアクセスできるアカウント。
- 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）を入力します。 - 起動ダイアログ - ダイアログはウィンドウ処理され、カードベースで行われます。 アプリがユーザーとやり取りするために開くことができるインターフェース。複数のカード 複数のステップを順番につなぐことができる プロセスを自動化できます。
- Codelab: より高度なアプリケーションを構築する準備が整いました。 Chat 用アプリですか？フィードバックを見る Codelab の Chat アプリ Gemini を使用して Google Chat 用アプリを構築する。