このページでは、 Google Chat アプリ。アプリホームはカスタマイズ可能なカード インターフェース ユーザーがダイレクト メッセージやチャット メッセージを開いたときに メッセージを追加できます。
たとえば 操作のヒントを含めるためにアプリのホームカードのメッセージを設定する Chat 用アプリ スラッシュ コマンドを使用します。エンドユーザーにとって、アプリのホームは Chat アプリのダイレクト メッセージでしか使用できず、 アプリ デベロッパーがこの機能を有効にします。
カードビルダーを使用して、Chat 用アプリ用の JSON カード メッセージを設計し、プレビューします。
カードビルダーを開く前提条件
Python
インタラクティブ機能を有効にする Google Chat アプリ。新しい HTTP サービスを使用したインタラクティブな Chat アプリについては、こちらのクイックスタートを完了します。
Apps Script
インタラクティブ機能を有効にする Google Chat アプリ。新しい インタラクティブな Chat アプリを使用するには、こちらのクイックスタートを完了してください。
Node.js
インタラクティブ機能を有効にする Google Chat アプリ。新しい HTTP サービスを使用したインタラクティブな Chat アプリについては、こちらのクイックスタートを完了します。
Java
インタラクティブ機能を有効にする Google Chat アプリ。新しい HTTP サービスを使用したインタラクティブな Chat アプリについては、こちらのクイックスタートを完了します。
Chat API を構成する
アプリのホームをサポートするには、Chat API の構成を更新する必要があります 確認できます。
Python
Google Cloud コンソールで [メニュー] に移動します。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API。
[管理] をクリックしてから、[構成] タブをクリックします。
[App Home をサポートする] チェックボックスをオンにします。
[App Home URL] フィールドに URL を追加します。通常この値は [App URL] に URL を入力します。この URL の呼び出し元
APP_HOME
イベント。[保存] をクリックします。
Apps Script
Google Cloud コンソールで [メニュー] に移動します。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API。
[管理] をクリックしてから、[構成] タブをクリックします。
[App Home をサポートする] チェックボックスをオンにします。
[保存] をクリックします。
Node.js
Google Cloud コンソールで [メニュー] に移動します。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API。
[管理] をクリックしてから、[構成] タブをクリックします。
[App Home をサポートする] チェックボックスをオンにします。
[App Home URL] フィールドに URL を追加します。通常この値は [App URL] に URL を入力します。この URL の呼び出し元
APP_HOME
イベント。[保存] をクリックします。
Java
Google Cloud コンソールで [メニュー] に移動します。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API。
[管理] をクリックしてから、[構成] タブをクリックします。
[App Home をサポートする] チェックボックスをオンにします。
[App Home URL] フィールドに URL を追加します。通常この値は [App URL] に URL を入力します。この URL の呼び出し元
APP_HOME
イベント。[保存] をクリックします。
アプリのホームを作成する
<ph type="x-smartling-placeholder">
アプリのホームカードは、ユーザーが Google Chat アプリから Chat 用アプリで応答として更新できます。 ボタンのクリック、フォームの送信、ダイアログの閉じなどのインタラクティブなイベントです。
次の例では、Chat 用アプリに 最初のアプリのホームカード。カードの作成時刻と、 ボタン。ユーザーがボタンをクリックすると、Chat 用アプリが は、更新されたカードが作成された時刻を示す、更新されたカードを返します。
アプリのホームの最初のカードを作成する
アプリのホームを構築するには、Chat 用アプリで
APP_HOME
インタラクション イベントを実行し、
RenderActions
pushCard
ナビゲーション。
Python
Apps Script
すべての APP_HOME
イベントの後に呼び出される onAppHome
関数を実装します。
この例では、メッセージにカード メッセージを送信する際に、 カード JSON。 また、 Apps Script カードサービス。
Node.js
Java
アプリのホームカードを更新する
アプリの最初のホームカードに、ボタンなどのインタラクティブなウィジェットが含まれている場合
Chat アプリは、入力または選択入力を
関連するインタラクション イベントを
RenderActions
「updateCard
」ナビゲーションを使用。インタラクティブランナーの処理と
詳細は
ユーザーが入力した情報を処理する。
制限事項
一般的に
navigation
:
Chat アプリでは利用できない。カードのスタックを返すことはできません。
pushCard
(初回応答用)と updateCard
(アップデート用)のみ
Chat 用アプリで利用できます。
関連トピック
- アプリのホームを使用する Chat アプリのサンプルを見る。
ダイアログを開くには、
OPEN_DIALOG
インタラクションを使用します。詳しくは アプリのホームカードに応じてダイアログを開く。ダイアログを閉じるには、
CLOSE_DIALOG
インタラクションを使用してダイアログを閉じます アプリのホームカードに戻るか、CLOSE_DIALOG_EXECUTE
を使用します。 操作でダイアログを閉じて、アプリのホームカードを更新します。対象 詳細については、以下をご覧ください。 アプリのホームカードのダイアログに応答する。アプリのホームの使用例については、 Codelab: 問題管理用の Chat アプリ Gemini を使用して Google Chat 用アプリを構築する。