Erstellen Sie eine Google Chat-App, der Sie direkt Nachrichten senden können und die mit einem Echo antwortet.
Das folgende Diagramm zeigt das Architektur- und Messaging-Muster:
Im obigen Diagramm hat ein Nutzer, der mit einer Apps Script Chat-Anwendung interagiert, den folgenden Informationsfluss:
- Ein Nutzer sendet eine Nachricht an eine Chat-App, entweder in einer Direktnachricht oder in einem Chatbereich.
- Die Logik der Chat-Anwendung, die in Apps Script implementiert ist und sich in Google Cloud befindet, empfängt und verarbeitet die Nachricht.
- Optional kann die Chat-Anwendungslogik in Google Workspace-Dienste wie Google Kalender oder Google Tabellen oder andere Google-Dienste wie Google Maps oder YouTube eingebunden werden.
- Die Chat-Anwendungslogik sendet eine Antwort an den Chat-App-Dienst in Chat zurück.
- Die Antwort wird dem Nutzer zugestellt.
Zielsetzungen
- die Umgebung einrichten
- Richten Sie das Skript ein.
- Veröffentlichen Sie die Chat-App.
- Chat App testen
Voraussetzungen
- Ein Google Workspace-Konto mit Zugriff auf Chat.
- Ein Google Cloud-Projekt
Umgebung einrichten
Cloud-Projekt in der Google Cloud Console öffnen
Falls noch nicht geschehen, öffnen Sie das Cloud-Projekt, das Sie für dieses Beispiel verwenden möchten:
- Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.
- Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Oder klicken Sie auf Projekt erstellen und folgen Sie der Anleitung auf dem Bildschirm. Wenn Sie ein Google Cloud-Projekt erstellen, müssen Sie möglicherweise die Abrechnung für das Projekt aktivieren.
Chat API aktivieren
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.
OAuth-Zustimmungsbildschirm konfigurieren
Für alle Apps, die OAuth 2.0 verwenden, ist ein Zustimmungsbildschirm konfiguriert. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer Anwendung konfigurieren, wird festgelegt, was Nutzern und Prüfern angezeigt wird. Außerdem wird die Anwendung registriert, damit Sie sie später veröffentlichen können.
- Rufen Sie in der Google Cloud Console das Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm. auf
- Wählen Sie für Nutzertyp die Option Intern aus und klicken Sie dann auf Erstellen.
- Füllen Sie das App-Registrierungsformular aus und klicken Sie dann auf Speichern und fortfahren.
Vorerst können Sie das Hinzufügen von Bereichen überspringen und auf Speichern und fortfahren klicken. Wenn Sie in Zukunft eine Anwendung außerhalb Ihrer Google Workspace-Organisation erstellen, müssen Sie den Nutzertyp in Extern ändern und dann die für die Anwendung erforderlichen Autorisierungsbereiche hinzufügen.
- Prüfen Sie die Zusammenfassung der App-Registrierung. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Bearbeiten. Wenn die Anwendungsregistrierung in Ordnung ist, klicken Sie auf Zurück zum Dashboard.
Skript einrichten
Verwenden Sie zum Einrichten des Skripts eine Vorlage und richten Sie dann Ihr Cloud-Projekt in Apps Script ein.
Script aus der Vorlage erstellen
- Rufen Sie die Seite Erste Schritte mit Apps Script auf.
- Klicken Sie auf die Vorlage Chat-App. Eventuell müssen Sie nach unten scrollen, um diese Vorlage zu sehen.
- Klicken Sie auf Unbenanntes Projekt, geben Sie
Quickstart app
ein und klicken Sie auf Umbenennen.
Cloud-Projektnummer kopieren
- Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > IAM und Verwaltung > Einstellungen.
- Kopieren Sie den Wert im Feld Projektnummer.
Cloud-Projekt des Apps Script-Projekts festlegen
- Klicken Sie im Apps Script-Projekt der Chat-App auf Projekteinstellungen .
- Klicken Sie unter Google Cloud Platform-Projekt (GCP) auf Projekt ändern.
- Fügen Sie unter GCP-Projektnummer die Google Cloud-Projektnummer ein.
- Klicken Sie auf Projekt festlegen.
Sie haben jetzt funktionierenden Anwendungscode, den Sie wie in den folgenden Schritten beschrieben ausprobieren und dann an Ihre Anforderungen anpassen können.
Achten Sie beim Öffnen der Apps Script-Vorlage darauf, dass Sie im richtigen Google-Konto angemeldet sind. Das aktuelle Konto kann manchmal zum Standardkonto wechseln, ohne dass Sie es merken.
Testbereitstellung erstellen
Für dieses Apps Script-Projekt benötigen Sie eine Bereitstellungs-ID, die Sie im nächsten Schritt verwenden können.
So rufen Sie die Head-Deployment-ID ab:
- Klicken Sie im Apps Script-Projekt der Chat-App auf Bereitstellen > Bereitstellungen testen.
- Kopieren Sie die Head-Deployment-ID zur Verwendung in einem späteren Schritt und klicken Sie auf Done (Fertig).
Chat-App veröffentlichen
Veröffentlichen Sie die Chat-App über die Google Cloud Console.
- Suchen Sie in der Google Cloud Console nach
Google Chat API
und klicken Sie auf Google Chat API. - Klicke auf Verwalten.
Klicken Sie auf Konfiguration und richten Sie die Chat-App ein:
- Geben Sie im Feld App-Name den Wert
Quickstart app
ein. - Geben Sie im Feld Avatar-URL den Wert
https://developers.google.com/chat/images/quickstart-app-avatar.png
ein. - Geben Sie im Feld Beschreibung den Text
Quickstart app
ein. - Wählen Sie unter „Funktionalität“ 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
- Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus.
- Fügen Sie in das Feld Deployment ID (Bereitstellungs-ID) die Head-Deployment-ID ein, die Sie zuvor kopiert haben.
- Wählen Sie unter Sichtbarkeit die Option Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E-Mail-Adresse ein.
- Geben Sie im Feld App-Name den Wert
Klicken Sie auf Speichern.
Die Google Chat App ist bereit, auf Nachrichten zu antworten.
Chat App testen
Öffnen Sie zum Testen der Chat-App einen Direktnachrichtbereich mit der Chat-App und senden Sie eine Nachricht:
Öffnen Sie Google Chat mit dem Google Workspace-Konto, das Sie bei der Registrierung als Trusted Tester angegeben haben.
- Klicken Sie auf Neuer Chat.
- Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihrer Chat-App ein.
Wählen Sie Ihre Chat-App aus den Ergebnissen aus. Eine Direktnachricht wird geöffnet.
Geben Sie in der neuen Direktnachricht an die App
Hello
ein und drücken Sieenter
.Die Chat-App bedankt sich für das Hinzufügen und gibt Ihre Nachricht wieder.
Unter Interaktive Funktionen für Google Chat-Apps testen erfahren Sie, wie Sie Trusted Tester hinzufügen und mehr über das Testen interaktiver Funktionen erfahren.
Fehlerbehebung
Wenn eine Google Chat-App oder -Karte einen Fehler zurückgibt, wird in der Chat-Oberfläche die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage kann nicht verarbeitet werden“. Manchmal wird in der Chat-UI keine Fehlermeldung angezeigt, die Chat-App oder -Karte aber ein unerwartetes Ergebnis, z. B. wird keine Kartennachricht angezeigt.
Obwohl möglicherweise keine Fehlermeldung in der Chat-UI angezeigt wird, stehen beschreibende Fehlermeldungen und Protokolldaten zur Verfügung, mit denen Sie Fehler beheben können, wenn das Fehler-Logging für Chat-Anwendungen aktiviert ist. Informationen zum Ansehen, Debuggen und Beheben von Fehlern finden Sie unter Google Chat-Fehler beheben.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, sollten Sie das Cloud-Projekt löschen.
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf Menü > IAM und Verwaltung > Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.
Nächste Schritte
- Interaktive Karten erstellen: Kartennachrichten unterstützen ein definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Verwende Kartennachrichten, um detaillierte Informationen zu präsentieren, Informationen von Nutzern zu sammeln und Nutzer zum nächsten Schritt zu führen.
- Slash-Befehle unterstützen: Mit Slash-Befehlen können Sie bestimmte Befehle registrieren und bewerben, die Nutzer Ihrer Anwendung geben können. Geben Sie dazu einen Befehl ein, der mit einem Schrägstrich (
/
) beginnt, z. B./help
. - Dialogfelder starten: Dialogfelder sind kartenbasierte Oberflächen im Fenster, die Ihre App für die Interaktion mit einem Nutzer öffnen kann. Mehrere Karten können aufeinanderfolgend aneinandergereiht werden, was Nutzern dabei hilft, mehrstufige Prozesse wie das Ausfüllen von Formulardaten auszuführen.
- Apps für Google Chat mit Gemini erstellen. Codelab:Sind Sie bereit, eine erweiterte Chat-App zu erstellen? Weitere Informationen finden Sie in der Feedback App aus dem Codelab unter