Google Chat-App mit Google Apps Script erstellen

Erstellen Sie eine Google Chat-App, der Sie direkt Nachrichten senden können und die Ihre Nachrichten in den Antworten einbezieht.

Das folgende Diagramm zeigt die Architektur und das Messaging-Muster:

Im vorherigen Diagramm wird der Informationsfluss bei der Interaktion eines Nutzers mit einer Apps Script-Chat-App so dargestellt:

1. Ein Nutzer sendet eine Nachricht an eine Chat-App, entweder als Direktnachricht oder in einem Chat-Bereich.
2. Die in Apps Script implementierte Chat-App-Logik, die sich in Google Cloud befindet, empfängt und verarbeitet die Nachricht.
3. Optional kann die Logik der Chat-App in Google Workspace-Dienste wie Google Kalender oder Google Tabellen oder in andere Google-Dienste wie Google Maps oder YouTube eingebunden werden.
4. Die Logik der Chat App sendet eine Antwort zurück an den Chat App-Dienst in Chat.
5. Die Antwort wird an den Nutzer gesendet.

Lernziele

• die Umgebung einrichten
• Richten Sie das Skript ein.
• Veröffentlichen Sie die Chat App.
• Chat App testen

Vorbereitung

• Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
• Ein Google Cloud-Projekt. Google Cloud-Projekt erstellen

Umgebung einrichten

Cloud-Projekt in der Google Cloud Console öffnen

Öffnen Sie das Cloud-Projekt, das Sie für dieses Beispiel verwenden möchten, falls es noch nicht geöffnet ist:

1. Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.

   Cloud-Projekt auswählen

2. Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Klicken Sie alternativ 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.

  API aktivieren

OAuth-Zustimmungsbildschirm konfigurieren

Für alle Apps, die OAuth 2.0 verwenden, ist eine Konfiguration des Zustimmungsbildschirms erforderlich. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer App konfigurieren, legen Sie fest, was Nutzern und App-Prüfern angezeigt wird. Außerdem wird Ihre App registriert, damit Sie sie später veröffentlichen können.

1. Rufen Sie in der Google Cloud Console das Menü  > > Branding auf.

   Zu Branding

2. Wenn Sie die bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:
1. Geben Sie unter App-Informationen im Feld App-Name einen Namen für die App ein.
2. Wählen Sie unter E-Mail-Adresse des Nutzersupports eine Support-E-Mail-Adresse aus, über die Nutzer Sie mit Fragen zu ihrer Einwilligung kontaktieren können.
3. Klicken Sie auf Weiter.
4. Wählen Sie unter Zielgruppe die Option Intern aus.
5. Klicken Sie auf Weiter.
6. Geben Sie unter Kontaktdaten eine E-Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
7. Klicken Sie auf Weiter.
8. Sehen Sie sich unter Fertigstellen die Nutzerdatenrichtlinie für Google API-Dienste an. Wenn Sie damit einverstanden sind, wählen Sie Ich stimme der Nutzerdatenrichtlinie für Google API-Dienste zu aus.
9. Klicken Sie auf Weiter.
10. Klicken Sie auf Erstellen.
3. Sie können das Hinzufügen von Bereichen vorerst überspringen. Wenn Sie in Zukunft eine App für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, müssen Sie den Nutzertyp in Extern ändern. Fügen Sie dann die Autorisierungsbereiche hinzu, die für Ihre App erforderlich sind. Weitere Informationen finden Sie in der vollständigen Anleitung OAuth-Zustimmung konfigurieren.

Skript einrichten

Zum Einrichten des Skripts verwenden Sie eine Vorlage und legen dann Ihr Cloud-Projekt in Apps Script fest.

Skript aus der Vorlage erstellen

1. Rufen Sie die Apps Script-Seite Erste Schritte auf.
2. Klicken Sie oben auf der Seite auf die Vorlage Chat-App.
3. Klicken Sie auf Unbenanntes Projekt, geben Sie Quickstart app ein und klicken Sie auf Umbenennen.

Cloud-Projektnummer kopieren

1. Rufen Sie in der Google Cloud Console das Menü  > IAM & Verwaltung > Einstellungen auf.

   Weiter zur Seite „IAM & Verwaltung“

2. Kopieren Sie den Wert aus dem Feld Projektnummer.

Cloud-Projekt für das Apps Script-Projekt festlegen

1. Klicken Sie im Apps Script-Projekt der Chat App auf Projekteinstellungen .
2. Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
3. Fügen Sie die Google Cloud-Projektnummer in GCP-Projektnummer ein.
4. Klicken Sie auf Projekt festlegen.

Sie haben jetzt funktionierenden App-Code, den Sie ausprobieren (wie in den folgenden Schritten beschrieben) und dann an Ihre Anforderungen anpassen können.

Achten Sie darauf, dass Sie im richtigen Google-Konto angemeldet sind, wenn Sie die Apps Script-Vorlage öffnen. Das aktuelle Konto kann manchmal unbemerkt zum Standardkonto wechseln.

Testbereitstellung erstellen

Sie benötigen eine Bereitstellungs-ID für dieses Apps Script-Projekt, damit Sie sie im nächsten Schritt verwenden können.

So rufen Sie die ID des Head-Deployments ab:

1. Klicken Sie im Apps Script-Projekt der Chat-App auf Bereitstellen > Testbereitstellungen.
2. Kopieren Sie die Head-Deployment-ID zur Verwendung in einem späteren Schritt und klicken Sie auf Fertig.

Chat App veröffentlichen

Veröffentlichen Sie die Chat App über die Konsole.

1. Suchen Sie in der Konsole nach Google Chat API und klicken Sie auf Google Chat API.
2. Klicken Sie auf Verwalten.

3. Klicken Sie auf Konfiguration und richten Sie die Chat-App ein:

   1. Geben Sie im Feld App-Name Quickstart app ein.
   2. Geben Sie im Feld Avatar-URL den Wert https://developers.google.com/chat/images/quickstart-app-avatar.png ein.
   3. Geben Sie im Feld Beschreibung den Text Quickstart app ein.
   4. Wählen Sie unter Funktionsweise die Option Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
   5. Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script aus.
   6. Fügen Sie in das Feld Deployment ID (Deployment-ID) die Head-Deployment-ID ein, die Sie zuvor kopiert haben.
   7. Wählen Sie unter „Sichtbarkeit“ die Option Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E-Mail-Adresse ein.

4. Klicken Sie auf Speichern.

Die Chat App ist bereit, auf Nachrichten zu antworten.

Chat App testen

So testen Sie Ihre Chat-App: Öffnen Sie einen Direktnachrichtenbereich mit der Chat-App und senden Sie eine Nachricht:

1. Öffnen Sie Google Chat mit dem Google Workspace-Konto, das Sie angegeben haben, als Sie sich als vertrauenswürdiger Tester hinzugefügt haben.

   Zu Google Chat wechseln

2. Klicken Sie auf  Neuer Chat.
3. Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihrer Chat-App ein.

4. Wählen Sie Ihre Chat-App aus den Ergebnissen aus. Eine Direktnachricht wird geöffnet.

   Hinweis:Wenn Ihre Chat-App nicht in der Ergebnisliste angezeigt wird, prüfen Sie, ob Sie Ihr Google Workspace-Konto in den Sichtbarkeitseinstellungen der Seite Chat API-Konfiguration in der Google Cloud Console angegeben haben.

5. Geben Sie in der neuen Direktnachricht mit der App Hello ein und drücken Sie enter.

   Die Chat-App bedankt sich dafür, dass Sie sie hinzugefügt haben, und wiederholt Ihre Nachricht.

Weitere Informationen zum Hinzufügen von vertrauenswürdigen Testern und zum Testen interaktiver Funktionen finden Sie unter Interaktive Funktionen für Google Chat-Apps testen.

Fehlerbehebung

Wenn eine Google Chat-App oder Karte einen Fehler zurückgibt, wird in der Chat-Benutzeroberfläche die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage kann nicht bearbeitet werden.“ Manchmal wird in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt, aber die Chat-App oder ‑Karte liefert ein unerwartetes Ergebnis, z. B. wird eine Kartennachricht nicht angezeigt.

Auch wenn in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt wird, sind aussagekräftige Fehlermeldungen und Protokolldaten verfügbar, die Ihnen helfen, Fehler zu beheben, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Informationen zum Aufrufen, 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, empfehlen wir, das Cloud-Projekt zu löschen.

Achtung:Das Löschen eines Projekts hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für diese Anleitung ein bereits bestehendes Projekt verwendet haben, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID verwenden, z. B. eine URL auf appspot.com, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf das Menü > IAM & Verwaltung > Ressourcen verwalten.

   Zum Ressourcenmanager

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
3. 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: Kartenmitteilungen unterstützen ein definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Mit Kartenmeldungen können Sie detaillierte Informationen präsentieren, Informationen von Nutzern erfassen und Nutzer zu einem nächsten Schritt anleiten.
• Auf Befehle reagieren: Mit Befehlen können Nutzer wichtige Funktionen Ihrer Chat-App entdecken und verwenden.
• Dialogfelder starten: Dialogfelder sind fensterbasierte, kartenbasierte Oberflächen, die Ihre App öffnen kann, um mit einem Nutzer zu interagieren. Mehrere Karten können sequenziell aneinandergereiht werden, was Nutzern hilft, mehrstufige Prozesse wie das Ausfüllen von Formulardaten zu durchlaufen.
• Codelab:Möchten Sie eine komplexere Chat-App erstellen? Feedback ansehen Chat-App aus dem Codelab Apps für Google Chat mit Gemini entwickeln.