Auf dieser Seite erfahren Sie, wie Sie eine Startseite für Ihr Google Chat App. Die App-Startseite ist eine anpassbare Kartenoberfläche die eine Chat-App an einen Nutzer sendet, wenn er eine direkte eine Nachricht mit der Chat App senden.
So können Sie zum Beispiel konfigurieren Sie die Nachricht auf der App-Startseite so, dass sie Tipps für die Interaktion mit der Chat-App mit Slash-Befehle verwenden. Für Endnutzer ist die App-Startseite in der Direktnachricht in einer Chat-App nur verfügbar, wenn die App-Entwickler die Funktion aktiviert.
Mit dem Card Builder können Sie JSON-Kartennachrichten für Chat-Apps erstellen und als Vorschau ansehen:
Card Builder öffnenVorbereitung
Python
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Apps Script
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein interaktive Chat-App in Apps Script verwenden möchten, führen Sie diese Kurzanleitung aus.
Node.js
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Java
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Chat API konfigurieren
Damit die App-Startseite unterstützt wird, müssen Sie Ihre Chat API-Konfiguration aktualisieren in der Google Cloud Console.
Python
Rufen Sie in der Google Cloud Console das Menü auf. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API.
Klicken Sie auf Manage (Verwalten) und dann auf den Tab Configuration (Konfiguration).
Klicken Sie das Kästchen Support-App-Startseite an.
Geben Sie im Feld URL der App-Startseite eine URL ein. Dieser Wert entspricht normalerweise URL als App-URL ein. Diese URL wird für
APP_HOME
Ereignisse.Klicken Sie auf Speichern.
Apps Script
Rufen Sie in der Google Cloud Console das Menü auf. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API.
Klicken Sie auf Manage (Verwalten) und dann auf den Tab Configuration (Konfiguration).
Klicken Sie das Kästchen Support-App-Startseite an.
Klicken Sie auf Speichern.
Node.js
Rufen Sie in der Google Cloud Console das Menü auf. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API.
Klicken Sie auf Manage (Verwalten) und dann auf den Tab Configuration (Konfiguration).
Klicken Sie das Kästchen Support-App-Startseite an.
Geben Sie im Feld URL der App-Startseite eine URL ein. Dieser Wert entspricht normalerweise URL als App-URL ein. Diese URL wird für
APP_HOME
Ereignisse.Klicken Sie auf Speichern.
Java
Rufen Sie in der Google Cloud Console das Menü auf. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API.
Klicken Sie auf Manage (Verwalten) und dann auf den Tab Configuration (Konfiguration).
Klicken Sie das Kästchen Support-App-Startseite an.
Geben Sie im Feld URL der App-Startseite eine URL ein. Dieser Wert entspricht normalerweise URL als App-URL ein. Diese URL wird für
APP_HOME
Ereignisse.Klicken Sie auf Speichern.
App-Startseite erstellen
<ph type="x-smartling-placeholder">
Die Karte auf der Startseite der App wird initiiert, wenn ein Nutzer eine Direktnachricht über die Chat-App, die aktualisiert werden kann, wenn Ein interaktives Ereignis wie das Klicken auf eine Schaltfläche, das Senden eines Formulars oder das Schließen eines Dialogfelds
Im folgenden Beispiel zeigt die Chat-App eine erste Karte auf der App-Startseite, auf der die Erstellungs- und eine Schaltfläche. Wenn ein Nutzer auf die Schaltfläche klickt, gibt eine aktualisierte Karte zurück, die den Erstellungszeitpunkt der aktualisierten Karte anzeigt.
Erste Karte für die Startseite der App erstellen
Damit ein App-Startseite erstellt werden kann, muss die Chat-App Folgendes verarbeiten:
APP_HOME
-Interaktionsereignisse und gibt eine Instanz von
RenderActions
mit pushCard
-Navigation.
Python
Apps Script
Implementieren Sie die onAppHome
-Funktion, die nach allen APP_HOME
-Ereignissen aufgerufen wird:
In diesem Beispiel wird eine Kartennachricht gesendet, JSON-Karte Sie können auch die Apps Script-Kartendienst
Node.js
Java
Karte auf der App-Startseite aktualisieren
Wenn die ursprüngliche Karte der App-Startseite interaktive Widgets enthält, z. B. Schaltflächen
oder Auswahleingaben muss Ihre Chat-App
der zugehörigen Interaktionsereignisse, indem eine Instanz von
RenderActions
mit updateCard
-Navigation. Weitere Informationen zum Umgang mit interaktiven
Widgets finden Sie unter
Von Nutzern eingegebene Informationen verarbeiten.
Python
Apps Script
In diesem Beispiel wird eine Kartennachricht gesendet, JSON-Karte Sie können auch die Apps Script-Kartendienst
Node.js
Java
Beschränkungen
Im Allgemeinen
navigation
ist
nicht für Chat-Apps verfügbar. Sie können keinen Stapel Karten zurückgeben.
Nur pushCard
(für die erste Antwort) und updateCard
(für Aktualisierungen) werden
für Chat-Apps verfügbar.
Weitere Informationen
- Sehen Sie sich Beispiele für Chat-Apps an, in denen die Startseite der App verwendet wird.
Verwenden Sie die Interaktion
OPEN_DIALOG
, um ein Dialogfeld zu öffnen. Weitere Informationen Siehe Dialogfeld als Antwort auf die Karte einer App-Startseite öffnen:Wenn Sie ein Dialogfeld schließen möchten, verwenden Sie die Interaktion
CLOSE_DIALOG
und kehre zur Karte auf der Startseite der App zurück oder verwendeCLOSE_DIALOG_EXECUTE
Interaktion, um das Dialogfeld zu schließen und die Karte auf der Startseite der App zu aktualisieren. Für finden Sie unter Auf einen Dialog zur Karte auf der App-Startseite reagieren:Ein Beispiel für die Verwendung der App-Startseite findest du auf der Chat-App zur Problemverwaltung im Codelab Apps für Google Chat mit Gemini erstellen