Auf dieser Seite wird erläutert, wie Sie mit Google Cloud Functions eine Chat-App erstellen und damit interagieren.
Zum Erstellen der Anwendung schreiben und stellen Sie eine Cloud Functions-Funktion bereit, mit der die Anwendung eine Antwort auf ein Nachrichtenereignis aus Google Chat verarbeitet. Die Antwort ist eine Karte, die den Namen des Senders und das Avatarbild enthält, wie in der folgenden Abbildung dargestellt:
Zielsetzungen
- die Umgebung einrichten
- eine Cloud Functions-Funktion erstellen und bereitstellen
- Veröffentlichen Sie die App in Google Chat.
- Testen Sie die App.
Vorbereitung
- Ein Google Workspace-Konto mit Zugriff auf Google Chat.
- Ein Google Cloud-Projekt
- Aktivieren Sie die Abrechnung für Ihr Cloud-Projekt. Weitere Informationen zum Bestätigen 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 und die Cloud Pub/Sub 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 die Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie die Funktion auf der Seite „Funktion erstellen“ 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.
Weitere Informationen zur Authentifizierung in Google Workspace finden Sie unter Chat-Apps und API-Anfragen authentifizieren und autorisieren.
Klicken Sie auf Speichern.
Klicken Sie auf Weiter.
Wählen Sie unter Laufzeit die Option Node.js 10 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 die Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie die Funktion auf der Seite „Funktion erstellen“ 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.
Weitere Informationen zur Authentifizierung in Google Workspace finden Sie unter Chat-Apps und API-Anfragen authentifizieren und autorisieren.
Klicken Sie auf Speichern.
Klicken Sie auf Weiter.
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 die Chat-App ausgewählt ist.
Klicken Sie auf
Funktion erstellen.Richten Sie die Funktion auf der Seite „Funktion erstellen“ 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.
Weitere Informationen zur Authentifizierung in Google Workspace finden Sie unter Chat-Apps und API-Anfragen authentifizieren und autorisieren.
Klicken Sie auf Speichern.
Klicken Sie auf Weiter.
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 Seite „Cloud Functions“ wird geöffnet und die Funktion wird neben dem Funktionsnamen mit einem Bereitstellungsfortschritt angezeigt. Wenn die Fortschrittsanzeige nicht mehr zu sehen ist, wird ein Häkchen angezeigt.
App in Google Chat veröffentlichen
Nach der Bereitstellung der Cloud Functions-Funktion können Sie sie in eine Google Chat-App umwandeln:
Klicken Sie in der Google Cloud Console auf das Dreistrich-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“ und klicken Sie auf Google Chat API.
Klicken Sie 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 (Avatar-URL)
https://developers.google.com/chat/images/quickstart-app-avatar.png
ein. - Geben Sie unter Beschreibung
Quickstart app
ein. - Wählen Sie unter Funktionsmerkmale die Option 1:1-Nachrichten empfangen, Gruppenbereiche und Gruppenunterhaltungen beitreten und Fehler in Cloud Logging protokollieren 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 Berechtigungen die Option Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E-Mail-Adresse ein.
- Geben Sie unter App-Name
Klicken Sie auf Speichern.
Die App kann 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.
- Wenn Sie eine Direktnachricht an die Anwendung senden möchten, klicken Sie auf „Chat starten“ und dann im eingeblendeten Fenster auf Apps suchen.
- Suchen Sie im Dialogfeld Apps suchen nach „Kurzanleitungs-App“.
- Wenn Sie eine Direktnachricht mit der Anwendung öffnen möchten, suchen Sie die Kurzanleitungs-App und klicken Sie auf Hinzufügen > Chat.
- Geben Sie in der Direktnachricht
Hello
ein und drücken Sieenter
.
Die App gibt dann eine Karte mit deinem Anzeigenamen und Avatarbild zurück.
Nächste Schritte
Informationen zur Fehlerbehebung in der Chat App finden Sie auf den folgenden Seiten:
- Beim Erstellen der Chat-App müssen Sie möglicherweise Fehler beheben, indem Sie die Fehlerlogs der App lesen. Rufen Sie zum Lesen der Logs in der Google Cloud Console den Log-Explorer auf.
- Fehlerbehebung
In den folgenden Leitfäden erfahren Sie, wie Sie die Chat-App um zusätzliche Funktionen ergänzen:
- Interaktive Karten erstellen: Kartennachrichten unterstützen ein bestimmtes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media-Elemente wie Bilder. Verwenden Sie Kartennachrichten, um detaillierte Informationen zu präsentieren, Informationen von Nutzern zu sammeln und Nutzer zum nächsten Schritt zu leiten.
- Slash-Befehle unterstützen – Mit Slash-Befehlen können Sie bestimmte Befehle registrieren und bewerben, die Nutzer Ihrer App geben können. Dazu geben sie einen Befehl ein, der mit einem Schrägstrich (
/
) beginnt, z. B./help
. - Dialogfelder zum Starten: Dialogfelder sind kartenbasierte Schnittstellen mit Fenstern, die Ihre App öffnen kann, um mit einem Nutzer zu interagieren. Mehrere Karten können nacheinander aufeinanderfolgend sein. Das hilft Nutzern, mehrstufige Prozesse auszuführen, z. B. das Ausfüllen von Formulardaten.
Weitere Informationen zur Google Chat API finden Sie in der Referenzdokumentation.