Auf dieser Seite erfahren Sie, wie Sie eine Startseite für Direktnachrichten mit Ihrem Google Chat App. Eine Startseite, die im Google Ads-System als App-Startseite bezeichnet wird Die Google Chat API ist eine anpassbare Kartenoberfläche auf dem Tab Startseite. von Gruppenbereiche für Direktnachrichten zwischen einem Nutzer und einer Chat-App.
Über die Startseite der App kannst du Tipps zur Interaktion mit den Chat-App oder lassen Sie Nutzer auf eine externen Dienst oder Tool von Chat
Mit dem Card Builder können Sie Nachrichten und Benutzeroberflächen für Chat-Apps entwerfen und in der Vorschau ansehen:
Card Builder öffnenVorbereitung
Node.js
Eine Google Chat-App, für die interaktive Funktionen aktiviert sind. Wenn Sie eine interaktive Chat-App mit einem HTTP-Dienst erstellen möchten, folgen Sie dieser Kurzanleitung.
Python
Eine Google Chat-App, für die interaktive Funktionen aktiviert sind. 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. Wenn Sie eine interaktive Chat-App mit einem HTTP-Dienst erstellen möchten, folgen Sie dieser Kurzanleitung.
Apps Script
Eine Google Chat App mit aktivierten interaktiven Funktionen. Wenn Sie eine interaktive Chat-App in Apps Script erstellen möchten, folgen Sie dieser Kurzanleitung.
App-Startseite für Ihre Chat-App konfigurieren
Wenn Sie den App-Startbildschirm unterstützen möchten, müssen Sie Ihre Chat-App so konfigurieren, dass sie APP_HOME
-Interaktionsereignisse empfängt. Ihre Chat-App empfängt dieses Ereignis, wenn ein Nutzer in einer Direktnachricht in der Chat-App auf den Tab Start klickt.
So aktualisieren Sie die Konfigurationseinstellungen in der Google Cloud Console:
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).
Gehen Sie unter Interaktive Funktionen zum Abschnitt Funktionen, um die App-Startseite zu konfigurieren:
- Klicken Sie das Kästchen 1:1-Nachrichten empfangen an.
- Klicken Sie das Kästchen Support App Home an.
Wenn Ihre Chat-App einen HTTP-Dienst verwendet, gehen Sie zu Verbindungseinstellungen und geben Sie einen Endpunkt für die App Home URL (URL der App-Startseite) ein. Sie können dieselbe URL verwenden, die Sie im Feld HTTP-Endpunkt-URL angegeben haben.
Klicken Sie auf Speichern.
Startseite einer App erstellen
Wenn ein Nutzer den App-Startbildschirm öffnet, muss Ihre Chat-App
APP_HOME
-Interaktionsereignis, indem eine Instanz von
RenderActions
mit pushCard
-Navigation und einem
Card
Für eine interaktive Nutzung können die Karten interaktive Widgets wie Schaltflächen oder Textfelder enthalten, die die Chat-App verarbeiten und mit zusätzlichen Karten oder einem Dialog beantworten kann.
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.
Node.js
Python
Java
Apps Script
Implementieren Sie die onAppHome
-Funktion, die nach allen APP_HOME
-Elementen aufgerufen wird.
Interaktionsereignisse:
In diesem Beispiel wird eine Kartennachricht gesendet, JSON-Karte Sie können auch die Apps Script-Kartendienst
Auf Interaktionen auf der App-Startseite reagieren
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.
Im vorherigen Beispiel enthielt die ursprüngliche Karte der App-Startseite eine Schaltfläche. Wenn ein Nutzer auf die Schaltfläche klickt, löst ein CARD_CLICKED
-Interaktionsereignis die Funktion updateAppHome
aus, um die Startkarte der App zu aktualisieren, wie im folgenden Code dargestellt:
Node.js
Python
Java
Apps Script
In diesem Beispiel wird eine Kartennachricht gesendet, JSON-Karte Sie können auch die Apps Script-Kartendienst
Dialogfelder öffnen
Ihre Chat-App kann auch auf Interaktionen reagieren auf dem Startbildschirm der App, indem Sie Dialogfelder öffnen.
Wenn Sie ein Dialogfeld über die Startseite der App öffnen möchten, verarbeiten Sie das zugehörige Interaktionsereignis, indem Sie renderActions
mit updateCard
-Navigation zurückgeben, die ein Card
-Objekt enthält. Im folgenden Beispiel antwortet eine Chat-App
auf einen Schaltflächenklick von einer App-Startseitenkarte durch Verarbeitung der CARD_CLICKED
Interaktionsereignis und das Öffnen eines Dialogfelds:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
Um ein Dialogfeld zu schließen, verarbeiten Sie die folgenden Interaktionsereignisse:
CLOSE_DIALOG
: Schließt das Dialogfeld und kehrt zur Startkarte der Chat-App zurück.CLOSE_DIALOG_AND_EXECUTE
: Schließt das Dialogfeld und aktualisiert den Startbildschirm der App .
Im folgenden Codebeispiel wird CLOSE_DIALOG
verwendet, um ein Dialogfeld zu schließen und zur
Karte auf der Startseite der App:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Sie können auch sequenzielle Dialoge erstellen, um Informationen von Nutzern zu erfassen. Informationen zum Erstellen von sequenziellen Dialogen finden Sie unter Dialoge öffnen und beantworten.
Weitere Informationen
- Chat-App-Beispiele ansehen, die den App-Startbildschirm verwenden
- Dialogfelder öffnen und beantworten