Auf dieser Seite wird erläutert, wie Sie eine HTTP Chat-Anwendung erstellen. Es gibt verschiedene Möglichkeiten, diese Architektur zu implementieren. In Google Cloud können Sie Cloud Functions, Cloud Run und App Engine verwenden. In dieser Kurzanleitung schreiben Sie eine Cloud Functions-Funktion, die die Chat-Anwendung verwendet, um auf die Nachricht eines Nutzers zu antworten.
Mit dieser Architektur konfigurieren Sie Chat für die Einbindung in Google Cloud oder einen lokalen Server mithilfe von HTTP, wie im folgenden Diagramm dargestellt:
Im obigen Diagramm sieht ein Nutzer, der mit einer HTTP Chat-Anwendung interagiert, den folgenden Informationsfluss:
- Ein Nutzer sendet eine Nachricht in Google Chat an eine Chat-Anwendung, entweder in einer Direktnachricht oder in einem Chatbereich.
- Eine HTTP-Anfrage wird an einen Webserver gesendet, der entweder ein Cloud- oder lokales System ist, das die Logik der Chat-Anwendung enthält.
- Optional kann die Chat-Anwendungslogik in Google Workspace-Dienste (z. B. Kalender und Tabellen), andere Google-Dienste (wie Maps, YouTube und Vertex AI) oder andere Webdienste (z. B. ein Projektmanagementsystem oder ein Tickettool) eingebunden werden.
- Der Webserver sendet eine HTTP-Antwort an den Chat-Anwendungsdienst in Chat zurück.
- Die Antwort wird an den Nutzer übermittelt.
- Optional kann die Chat-Anwendung die Chat API aufrufen, um Nachrichten asynchron zu posten oder andere Vorgänge auszuführen.
Diese Architektur bietet Ihnen die Flexibilität, vorhandene Bibliotheken und Komponenten zu verwenden, die bereits in Ihrem System vorhanden sind, da diese Chat-Anwendungen mit verschiedenen Programmiersprachen entwickelt werden können.
Zielsetzungen
- die Umgebung einrichten
- Cloud Functions-Funktion erstellen und bereitstellen
- Veröffentlichen Sie die App in Google Chat.
- Testen Sie die App.
Voraussetzungen
- Ein Google Workspace-Konto mit Zugriff auf Google Chat in einer Google Workspace-Organisation, die nicht authentifizierte Aufrufe von Google Cloud Functions-Funktionen zulässt.
- Ein Google Cloud-Projekt
- Die Abrechnung für Ihr Cloud-Projekt muss aktiviert sein. Weitere Informationen zum Überprüfen des Abrechnungsstatus Ihrer Projekte
Umgebung einrichten
Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.Aktivieren Sie in der Google Cloud Console die Google Chat API, die Cloud Build API, die Cloud Functions API, die Cloud Pub/Sub API, die Cloud Logging API, die Artifact Registry API und die Cloud Run API.
Cloud Functions-Funktionen erstellen und bereitstellen
Eine Cloud Functions-Funktion erstellen und bereitstellen, die eine Chatkarte mit dem Anzeigenamen und dem Avatarbild des Absenders generiert. Wenn die Chat-App eine Nachricht empfängt, führt sie die Funktion aus und antwortet mit der Karte.
Führen Sie die folgenden Schritte aus, um die Funktion für Ihre Chat-App zu erstellen und bereitzustellen:
Node.js
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:
Prüfen Sie, ob das Projekt für Ihre Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie auf der Seite „Funktion erstellen“ Ihre Funktion ein:
- Wählen Sie unter Umgebung die Option 2nd gen aus.
- Geben Sie unter Funktionsname
QuickStartChatApp
ein. - Wählen Sie unter Region eine Region aus.
- Wählen Sie unter „Authentifizierung“ die Option Nicht authentifizierte Aufrufe zulassen aus.
- Klicken Sie auf Weiter.
Wählen Sie unter Laufzeit die Option Node.js 20 aus.
Wählen Sie unter Quellcode die Option Inline-Editor aus.
Löschen Sie unter Einstiegspunkt den Standardtext und geben Sie
helloChat
ein.Ersetzen Sie den Inhalt von
index.js
durch den folgenden Code:Klicken Sie auf Bereitstellen.
Python
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:
Prüfen Sie, ob das Projekt für Ihre Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie auf der Seite „Funktion erstellen“ Ihre Funktion ein:
- Geben Sie unter Funktionsname
QuickStartChatApp
ein. - Wählen Sie unter Triggertyp die Option HTTP aus.
- Wählen Sie unter „Authentifizierung“ die Option Nicht authentifizierte Aufrufe zulassen aus.
- Klicken Sie auf Speichern.
- Klicken Sie auf Weiter.
- Geben Sie unter Funktionsname
Wählen Sie unter Laufzeit die Option Python 3.10 aus.
Wählen Sie unter Quellcode die Option Inline-Editor aus.
Löschen Sie unter Einstiegspunkt den Standardtext und geben Sie
hello_chat
ein.Ersetzen Sie den Inhalt von
main.py
durch den folgenden Code:Klicken Sie auf Bereitstellen.
Java
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:
Prüfen Sie, ob das Projekt für Ihre Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie auf der Seite „Funktion erstellen“ Ihre Funktion ein:
- Geben Sie unter Funktionsname
QuickStartChatApp
ein. - Wählen Sie unter Triggertyp die Option HTTP aus.
- Wählen Sie unter „Authentifizierung“ die Option Nicht authentifizierte Aufrufe zulassen aus.
- Klicken Sie auf Speichern.
- Klicken Sie auf Weiter.
- Geben Sie unter Funktionsname
Wählen Sie unter Laufzeit die Option Java 11 aus.
Wählen Sie unter Quellcode die Option Inline-Editor aus.
Löschen Sie unter Einstiegspunkt den Standardtext und geben Sie
HelloChat
ein.Benennen Sie
src/main/java/com/example/Example.java
insrc/main/java/HelloChat.java
um.Ersetzen Sie den Inhalt von
HelloChat.java
durch den folgenden Code:Ersetzen Sie den Inhalt von
pom.xml
durch den folgenden Code:Klicken Sie auf Bereitstellen.
Die Cloud Functions-Detailseite wird geöffnet und Ihre Funktion wird mit zwei Fortschrittsanzeigen angezeigt: eine für den Build und eine für den Dienst. Wenn beide Fortschrittsanzeigen verschwinden und durch ein Häkchen ersetzt werden, ist Ihre Funktion bereitgestellt und bereit.
App in Google Chat veröffentlichen
Nachdem die Cloud Functions-Funktion bereitgestellt wurde, können Sie sie mit den folgenden Schritten in eine Google Chat-App umwandeln:
Klicken Sie in der Google Cloud Console auf das Menü > Cloud Functions.
Achten Sie darauf, dass das Projekt ausgewählt ist, für das Sie Cloud Functions aktiviert haben.
Klicken Sie in der Liste der Funktionen auf QuickStartChatApp.
Klicken Sie auf der Seite „Funktionsdetails“ auf Trigger.
Kopieren Sie unter Trigger-URL die URL.
Suchen Sie nach „Google Chat API“, klicken Sie auf Google Chat API und dann auf Verwalten.
Klicken Sie auf Konfiguration und richten Sie die Google Chat App ein:
- Geben Sie unter App-Name
Quickstart App
ein. - Geben Sie im Feld Avatar-URL den Wert
https://developers.google.com/chat/images/quickstart-app-avatar.png
ein. - Geben Sie unter Beschreibung den Wert
Quickstart app
ein. - Wählen Sie unter Funktionen die Option 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
- Wählen Sie unter Verbindungseinstellungen die Option App-URL aus und fügen Sie die URL für den Cloud Functions-Trigger in das Feld ein.
- Wählen Sie unter Sichtbarkeit die Option Diese Google Chat-Anwendung für bestimmte Personen und Gruppen in Ihrer Domain verfügbar machen aus und geben Sie Ihre E-Mail-Adresse ein.
- Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.
- Geben Sie unter App-Name
Klicken Sie auf Speichern.
Die Chat-App kann jetzt Nachrichten in Google Chat empfangen und beantworten.
Chat-App testen
Wenn Sie die Chat-App testen möchten, senden Sie der App eine Direktnachricht:
- Öffnen Sie Google Chat.
- Zum Senden einer Direktnachricht an die Anwendung klicken Sie auf „Chat starten“ und dann im angezeigten Fenster auf Apps suchen.
- Suchen Sie im Dialogfeld Apps suchen nach
Quickstart App
. - Um eine Direktnachricht mit der App zu öffnen, suchen Sie die Kurzanleitung und klicken Sie auf Hinzufügen > Chat.
- Geben Sie in der Direktnachricht
Hello
ein und drücken Sieenter
.
Die Antwort der Chat-Anwendung enthält eine Kartennachricht, die den Namen und das Avatarbild des Absenders enthält, wie in der folgenden Abbildung dargestellt:
Fehler beheben
Weitere Informationen
Informationen zum Hinzufügen weiterer Funktionen zu Ihrer Chat-App finden Sie hier: