Google Apps Script Chat アプリのクイックスタート

Google Chat アプリを作成して、 メッセージをエコーして応答します。

次の図は、アーキテクチャとメッセージング パターンを示しています。

Apps Script を使用して実装された Chat アプリのアーキテクチャ。

上の図では、Apps Script を操作するユーザーが Chat アプリには、次のような情報の流れがあります。

  1. ユーザーが Chat 用アプリにメッセージを送信すると、 ダイレクト メッセージまたは Chat スペースで作成できます。
  2. Chat 用アプリのロジックは、 Google Cloud にある Apps Script は、 メッセージを処理します。
  3. 必要に応じて、Chat 用アプリのロジックを Google Workspace サービス(Google カレンダーや スプレッドシート、またはその他の Google サービス(Google マップなど) YouTube で管理できます。
  4. Chat アプリのロジックは、 Chat での Chat アプリサービス。
  5. レスポンスがユーザーに送信されます。

目標

  • 環境を設定する。
  • スクリプトを設定します。
  • Chat アプリを公開します。
  • Chat アプリをテストします。

前提条件

環境の設定

Google Cloud コンソールで Cloud プロジェクトを開く

まだ開いていない場合は、使用する Cloud プロジェクトを開きます。 次のように設定します。

  1. Google Cloud コンソールで、[プロジェクトの選択] ページに移動します。

    Cloud プロジェクトを選択する

  2. 使用する Google Cloud プロジェクトを選択します。または、[プロジェクトを作成] をクリックし、画面の指示に従います。Google Cloud プロジェクトを作成する場合、プロジェクトの課金を有効にする必要があります。

Chat API を有効にする

Google API を使用する前に、Google Cloud プロジェクトで有効にする必要があります。 1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。
  • Google Cloud コンソールで、Google Chat API を有効にします。

    API の有効化

OAuth 2.0 を使用するすべてのアプリには、同意画面の設定が必要です。構成 アプリの OAuth 同意画面で、ユーザーとアプリに表示される内容が定義されます 審査担当者がアプリを登録し、後で公開できるようにします。

  1. Google Cloud コンソールで、メニュー に移動します。 > API とサービス > OAuth 同意画面

    OAuth 同意画面に移動

  2. [ユーザーの種類] で [内部] を選択し、[作成] をクリックします。
  3. アプリ登録フォームに入力し、[保存して次へ] をクリックします。
  4. 現時点では、スコープの追加をスキップして [保存して次へ] をクリックします。 将来的に、 [ユーザーの種類] を [外部] に変更してから、 アプリに必要な認証スコープを追加します。

  5. アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリが 問題がなければ、[ダッシュボードに戻る] をクリックします。

スクリプトを設定する

スクリプトを設定するには、テンプレートを使って Google Cloud プロジェクトを作成します。

テンプレートからスクリプトを作成する

  1. [ Apps Script のスタートガイド ページ
  2. [Chat App] テンプレートをクリックします。必要に応じて 見てみましょう。
  3. [無題のプロジェクト] をクリックして「Quickstart app」と入力し、 [名前を変更] をクリックします。

Cloud プロジェクト番号をコピーする

  1. Google Cloud コンソールで、メニュー に移動します。 > IAM と管理 > [設定] をタップします。

    [IAM と管理] の [設定] に移動

  2. [プロジェクト番号] フィールドに値をコピーします。

Apps Script プロジェクトの Cloud プロジェクトを設定する

  1. Chat 用アプリの Apps Script プロジェクトでは、 [プロジェクトの設定] プロジェクト設定のアイコン をクリックします。
  2. [Google Cloud Platform(GCP)プロジェクト] で、[プロジェクトを変更] をクリックします。
  3. [GCP プロジェクト番号] に、Google Cloud プロジェクト番号を貼り付けます。
  4. [プロジェクトを設定] をクリックします。

これで、試せるアプリコードが完成しました( 確認してから、要件に合わせてカスタマイズします。

Google Chat を開く際に、正しい Google アカウントにログインしていることを確認してください Apps Script テンプレート。現在のアカウントは、 自動的にデフォルトのアカウントに移行されます。

テストデプロイを作成する

この Apps Script プロジェクトのデプロイメント ID が必要です。これにより、 次のステップで使用できます。

ヘッドデプロイ ID を取得する手順は次のとおりです。

  1. Chat 用アプリの Apps Script プロジェクトでは、 [デプロイ] をクリックします。 > [デプロイをテスト] をクリックします。
  2. 後のステップで使用するためにヘッド デプロイ ID をコピーし、[完了] をクリックします。

Chat アプリを公開する

Google Cloud コンソールから Chat 用アプリを公開します。

  1. Google Cloud コンソールGoogle Chat API」を検索して [Google Chat API] をクリックします。
  2. [管理] をクリックします。
  3. [Configuration] をクリックして、Chat 用アプリを設定します。

    1. [App name] フィールドに「Quickstart app」と入力します。
    2. [アバターの URL] フィールドに、次のように入力します。 https://developers.google.com/chat/images/quickstart-app-avatar.png
    3. [説明] フィールドに「Quickstart app」と入力します。
    4. [機能] で [1:1 のメッセージを受信する] を選択し、 スペースやグループの会話に参加する
    5. [Connection settings] で [Apps Script project] を選択します。
    6. [Deployment ID] フィールドに、先ほど作成したヘッドデプロイ ID を貼り付けます。 使用します。
    7. [公開設定] で [組織内の特定のユーザーとグループ ドメイン] を選択し、メールアドレスを入力します。
  4. [保存] をクリックします。

Chat アプリでメッセージに応答できるようになりました。

Chat アプリをテストする

Chat 用アプリをテストするには、スペースを開いてダイレクト メッセージ スペースを開き、 メッセージを送信します。

  1. Google Workspace アカウントを持つユーザーを ご自身で Trusted Tester として追加した際に提供される通知もあわせてご確認ください。

    Google Chat にアクセス

  2. [ チャットを新規作成] をクリックします。
  3. [1 人以上のユーザーを追加] フィールドに、招待する Chat アプリ。
  4. 結果から Chat 用アプリを選択します。ダイレクト というメッセージが開きます。

  5. アプリとの新しいダイレクト メッセージで、「Hello」と入力し、 enter キーを押します。

    Chat アプリが追加に対する感謝とエコー できます。

Trusted Tester を追加し、インタラクティブ機能のテストについて詳しくは、以下をご覧ください。 インタラクティブ機能のテスト Google Chat アプリ

トラブルシューティング

Google Chat アプリまたは card がエラーを返した場合、 Chat のインターフェースに「エラーが発生しました」というメッセージが表示されている。 または「リクエストを処理できません」が表示されます。場合によっては、Chat の UI が エラー メッセージは表示されませんが、Chat 用アプリまたは 予期しない結果が生じた場合たとえば、カード メッセージに 表示されます。

Chat UI にエラー メッセージが表示されない場合がありますが、 エラーの修正に役立つ、わかりやすいエラー メッセージとログデータ Chat 用アプリのエラーロギングが有効になっている場合。表示のヘルプについては、 エラーの修正について詳しくは、このモジュールの Google Chat のエラーのトラブルシューティングと修正

クリーンアップ

サービス アカウントに対する Google Cloud アカウントへの課金を回避するために、 リソースがある場合は、その Terraform 構成ファイルを できます。

  1. Google Cloud コンソールで、[リソースの管理] ページに移動します。[ メニュー > IAM と管理者 > [リソースの管理] をクリックします。

    <ph type="x-smartling-placeholder"></ph> Resource Manager に移動

  2. プロジェクト リストで、削除するプロジェクトを選択し、[ 削除します。
  3. ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックして削除します。 できます。

次のステップ

  • インタラクティブなカードを作成する - カード メッセージは、定義されたレイアウト、ボタンなどのインタラクティブな UI 要素、 画像などのリッチメディアですカードメッセージを使って詳細情報を表示する ユーザーから情報を収集し、ユーザーが次のステップに進めるよう誘導する。
  • スラッシュ コマンドのサポート - スラッシュ コマンドを使用すると、 ユーザーがアプリに実行できる特定のコマンドを登録してアドバタイズする スラッシュ(/)で始まるコマンド(例: /help)を入力します。
  • 起動ダイアログ - ダイアログはウィンドウ処理され、カードベースで行われます。 アプリがユーザーとやり取りするために開くことができるインターフェース。複数のカード 複数のステップを順番につなぐことができる プロセスを自動化できます。
  • Codelab: より高度なアプリケーションを構築する準備が整いました。 Chat 用アプリですか?フィードバックを見る Codelab の Chat アプリ Gemini を使用して Google Chat 用アプリを構築する