GSP250

Übersicht

Google Chat-Bots sind eine nutzerfreundliche Möglichkeit, Zugriff auf die Daten und Dienste Ihres Unternehmens bereitzustellen. Ihre Nutzerinnen und Nutzer können sich per Chat ganz natürlich mit den Bots unterhalten. Eine Option zum Erstellen von Google Chat-Bots ist die Verwendung von Google Apps Script. So können Sie auch ganz einfach andere Google-Dienste wie Google Drive, Gmail, Google Kalender, Google Docs und Google Sheets einbinden.

In diesem Lab erstellen Sie mit Google Apps Script einen einfachen Google Chat-Bot, um sich mit dem Konzept der Google Chat-Bots vertraut zu machen.

Aufgaben

In diesem Lab arbeiten Sie die folgenden Aufgaben durch:

• Chat-App aus einer Vorlage mit automatisch eingefügten Event-Handlern erstellen
• Google Chat-Bot konfigurieren und veröffentlichen

Einrichtung und Anforderungen

Vor dem Klick auf „Start Lab“ (Lab starten)

Lesen Sie diese Anleitung. Labs sind zeitlich begrenzt und können nicht pausiert werden. Der Timer beginnt zu laufen, wenn Sie auf Lab starten klicken, und zeigt Ihnen, wie lange Google Cloud-Ressourcen für das Lab verfügbar sind.

In diesem praxisorientierten Lab können Sie die Lab-Aktivitäten in einer echten Cloud-Umgebung durchführen – nicht in einer Simulations- oder Demo-Umgebung. Dazu erhalten Sie neue, temporäre Anmeldedaten, mit denen Sie für die Dauer des Labs auf Google Cloud zugreifen können.

Für dieses Lab benötigen Sie Folgendes:

• Einen Standardbrowser (empfohlen wird Chrome)

• Zeit für die Durchführung des Labs – denken Sie daran, dass Sie ein begonnenes Lab nicht unterbrechen können.

Lab starten und bei der Google Cloud Console anmelden

1. Klicken Sie auf Lab starten. Wenn Sie für das Lab bezahlen müssen, wird ein Dialogfeld geöffnet, in dem Sie Ihre Zahlungsmethode auswählen können. Auf der linken Seite befindet sich der Bereich „Details zum Lab“ mit diesen Informationen:

   • Schaltfläche „Google Cloud Console öffnen“
   • Restzeit
   • Temporäre Anmeldedaten für das Lab
   • Ggf. weitere Informationen für dieses Lab

2. Klicken Sie auf Google Cloud Console öffnen (oder klicken Sie mit der rechten Maustaste und wählen Sie Link in Inkognitofenster öffnen aus, wenn Sie Chrome verwenden).

   Im Lab werden Ressourcen aktiviert. Anschließend wird ein weiterer Tab mit der Seite „Anmelden“ geöffnet.

   Tipp: Ordnen Sie die Tabs nebeneinander in separaten Fenstern an.

   Hinweis: Wird das Dialogfeld Konto auswählen angezeigt, klicken Sie auf Anderes Konto verwenden.

3. Kopieren Sie bei Bedarf den folgenden Nutzernamen und fügen Sie ihn in das Dialogfeld Anmelden ein.

   {{{user_0.username | "Username"}}}

   Sie finden den Nutzernamen auch im Bereich „Details zum Lab“.

4. Klicken Sie auf Weiter.

5. Kopieren Sie das folgende Passwort und fügen Sie es in das Dialogfeld Willkommen ein.

   {{{user_0.password | "Password"}}}

   Sie finden das Passwort auch im Bereich „Details zum Lab“.

6. Klicken Sie auf Weiter.

   Wichtig: Sie müssen die für das Lab bereitgestellten Anmeldedaten verwenden. Nutzen Sie nicht die Anmeldedaten Ihres Google Cloud-Kontos. Hinweis: Wenn Sie Ihr eigenes Google Cloud-Konto für dieses Lab nutzen, können zusätzliche Kosten anfallen.

7. Klicken Sie sich durch die nachfolgenden Seiten:

   • Akzeptieren Sie die Nutzungsbedingungen.
   • Fügen Sie keine Wiederherstellungsoptionen oder Zwei-Faktor-Authentifizierung hinzu (da dies nur ein temporäres Konto ist).
   • Melden Sie sich nicht für kostenlose Testversionen an.

Nach wenigen Augenblicken wird die Google Cloud Console in diesem Tab geöffnet.

Hinweis: Wenn Sie auf Google Cloud-Produkte und ‑Dienste zugreifen möchten, klicken Sie auf das Navigationsmenü oder geben Sie den Namen des Produkts oder Dienstes in das Feld Suchen ein.

Aufgabe 1: Chat-App aus einer Vorlage erstellen

Zum Implementieren Ihres Bots erstellen Sie in Google Apps Script ein neues Projekt auf Grundlage der Vorlage für Chat-Apps.

1. Klicken Sie auf diesen Link zur Startseite von Google Apps Script, um den Online-Editor von Google Apps Script zu öffnen.

2. Klicken Sie unter Google Workspace-Add-on-Starter auf Chat-App (Version für Fortgeschrittene).

3. Klicken Sie auf Unbenanntes Projekt. Das ist der vorläufige Name des Projekts.

4. Benennen Sie das Projekt im Dialogfeld Edit project name (Projektname bearbeiten) in Friendly Bot um und klicken Sie dann auf Umbenennen.

Ereignisse in Google Chat

Die meisten Interaktionen des Apps Script-Bots mit Google Chat sind ereignisgesteuert. Die Interaktionen zwischen den Nutzerinnen und Nutzern, dem Bot und Google Chat folgen in der Regel einer bestimmten Sequenz.

1. Eine Nutzerin oder ein Nutzer stößt eine Aktion an. Das kann zum Beispiel das Hinzufügen eines Bots zu einem Chatroom sein, das Senden einer Direktnachricht (DM) an einen Bot oder das Entfernen eines Bots aus einem Chatroom.
2. Die Aktion löst ein Ereignis aus, das an den Bot in Google Chat gerichtet ist.
3. Google Chat ruft den entsprechenden Event-Handler auf, der im Script des Bots definiert ist.

Google Chat löst vier Ereignisse aus, auf die Ihr Apps Script-Bot warten kann:

• ADDED_TO_SPACE: Dieses Ereignis tritt ein, sobald einem Chatroom oder einer DM von Nutzerseite aus ein Bot hinzugefügt wird. In Apps Script definieren Sie die Funktion onAddToSpace(), um dieses Ereignis zu verarbeiten.
• REMOVED_FROM_SPACE: Dieses Ereignis tritt ein, sobald ein Bot nutzerinitiiert aus einem Chatroom oder einer DM entfernt wird. Bei diesem Ereignis wird keine Antwort an Google Chat zurückgegeben. In Apps Script definieren Sie eine Funktion onRemoveFromSpace(), um dieses Ereignis zu verarbeiten.
• MESSAGE: Dieses Ereignis tritt ein, sobald eine nutzerinitiierte Nachricht an den Bot gesendet wird, entweder direkt als DM oder als @Erwähnung in einem Chatroom. In Apps Script definieren Sie eine Funktion onMessage(), um auf dieses Ereignis zu reagieren.

Code für den Event-Handler MESSAGE überprüfen

In der Vorlage für Chat-Apps werden die Event-Handler automatisch in die Codedatei eingefügt.

• Klicken Sie auf die Datei Code.gs, um die automatisch eingefügten Event-Handler zu überprüfen.

Sehen Sie sich die Event-Handler für die Ereignisse MESSAGE, ADDED_TO_SPACE und REMOVE_FROM_SPACE an. Sie führen die zuvor erwähnten Funktionen aus, um verschiedene Aufgaben zu erledigen, z. B. auf Nutzernachrichten in Google Chat zu antworten.

Aufgabe 2: Chatbot veröffentlichen und testen

Bevor Sie den Bot ausführen und testen können, müssen Sie die Google Chat API für Ihr Google Cloud-Projekt aktivieren und Ihren Bot veröffentlichen.

In dieser Aufgabe führen Sie die verschiedenen Konfigurationsschritte aus, die zur Veröffentlichung des Bots notwendig sind. Dazu gehören das Konfigurieren des OAuth-Zustimmungsbildschirms, das Aktualisieren der Apps Script-Anwendung, damit sie auf das richtige Google Cloud-Projekt verweist, und das Aktualisieren der Google Chat API-Konfiguration, damit der Bot zum Testen veröffentlicht wird.

OAuth-Zustimmungsbildschirm konfigurieren

1. Klicken Sie in der Google Cloud Console oben links auf das Navigationsmenü () und rufen Sie APIs und Dienste > OAuth-Zustimmungsbildschirm auf.

2. Klicken Sie auf Jetzt starten.

3. Konfigurieren Sie auf der Seite „Projektkonfiguration“ unter Anwendungsinformation die folgenden Einstellungen und klicken Sie dann auf Weiter:

4. Wählen Sie für Zielgruppe die Option Intern aus und klicken Sie auf Weiter.

5. Geben Sie unter Kontaktdaten die E‑Mail-Adresse ein und klicken Sie auf Weiter.

6. Akzeptieren Sie die Richtlinie und klicken Sie auf Weiter. Klicken Sie anschließend auf Erstellen.

Klicken Sie auf Fortschritt prüfen.

Nummer des Google Cloud-Projekts suchen und in Apps Script-Anwendung einfügen

1. Klicken Sie im Navigationsmenü () auf Cloud-Übersicht > Dashboard.

2. Suchen Sie im Dashboard den Abschnitt Projektinformationen.

3. Notieren Sie sich die Projektnummer, damit Sie sie im nächsten Schritt zum Konfigurieren Ihres Projekts verwenden können.

4. Kehren Sie zum Apps Script-Editor zurück und rufen Sie die Projekteinstellungen für das Projekt „Friendly Bot“ () auf.

5. Klicken Sie unter Google Cloud Platform-Projekt (GCP) auf Projekt wechseln.

6. Geben Sie unter GCP-Projektnummer die Projektnummer ein, die Sie sich vorhin notiert haben. Klicken Sie dann auf Projekt festlegen.

Chatbot konfigurieren und veröffentlichen

1. Klicken Sie im Apps Script-Editor oben rechts auf Bereitstellen > Deployments testen, um die Head-Deployment-ID für das Test-Deployment zu finden. Klicken Sie dann neben der ID auf Kopieren.

2. Gehen Sie in der Google Cloud Console zum Navigationsmenü () > APIs und Dienste > Bibliothek.

3. Suchen Sie in der Bibliothek nach Google Chat API und wählen Sie die API in der Ergebnisliste aus.

Die Google Chat API sollte in diesem Projekt bereits aktiviert sein. Wenn sie nicht aktiviert ist, klicken Sie auf Aktivieren.

4. Klicken Sie auf Verwalten und dann auf den Tab Konfiguration für die Google Chat API.

5. Legen Sie im Dialogfeld Konfiguration folgende Werte für die Felder fest:

6. Klicken Sie auf Speichern.

7. Scrollen Sie nach dem Speichern der Änderungen im Dialogfeld Konfiguration nach oben, um den Anwendungsstatus auf LIVE – für Nutzer verfügbar zu aktualisieren.

Möglicherweise müssen Sie die Seite aktualisieren, damit das Feld Anwendungsstatus angezeigt wird. Wenn der Wert für Anwendungsstatus bereits auf LIVE – für Nutzer verfügbar gesetzt ist, können Sie ihn so beibehalten. Speichern Sie die Seite aber im nächsten Schritt noch einmal.

8. Klicken Sie erneut auf Speichern.

Chatbot testen

Damit sind wir schon beim letzten Abschnitt angelangt. Führen Sie die folgenden Schritte aus, um Ihren Bot in Google Chat zu testen.

1. Klicken Sie auf den Link Google Chat, um Google Chat zu öffnen.

2. Wählen Sie Chat starten aus.

3. Suchen Sie nach Friendly Bot.

4. Wählen Sie in den Ergebnissen den von Ihnen erstellten Friendly Bot (Apps Script Lab Bot) aus, um einen Chat zu starten.

Sobald die Direktnachrichten geöffnet werden, sollten Sie eine Nachricht vom Bot sehen, in der er sich für das Hinzufügen zu der DM bedankt:

Thank you for adding me to a direct message, student XXXXX!

Diese Antwort wird durch die Funktion onAddedToSpace ausgelöst, die auf eines der ihr zugewiesenen Ereignisse reagiert: Der Bot wurde einem Google Chat-Bereich hinzugefügt.

5. Geben Sie als Letztes eine Nachricht an den Bot ein, zum Beispiel „Hello bot!“.

Der Bot sollte mit einer Wiederholung Ihrer Nachricht antworten, beispielsweise:

You said "Hello bot!"

Diese Antwort wird durch die Funktion onMessage ausgelöst, die auf das ihr zugewiesene Ereignis reagiert: Der Bot hat eine Nutzer-DM erhalten.

Geschafft!

Sie haben mit nur wenigen Schritten einen Google Chat-Bot erstellt, der auf Nutzernachrichten antwortet.

Weitere Informationen

• Weitere Beispiele für die Anwendungsentwicklung in Google Workspace:
  • Google Apps Script: Zugriff auf Google Sheets, Google Maps und Gmail mit nur vier Zeilen Code
• Nützliche Ressourcen:
  • Dokumentation für Google Chat
  • Kurzanleitung für die Bot-Erstellung mit Apps Script
  • Neue Bots erstellen
  • Bots veröffentlichen
  • Interaktive Karten erstellen
  • Referenz zu Karten
  • Referenz zu Ereignisobjekten
  • Referenz zu erweiterten Gmail-Diensten
  • API-Referenz zu Apps Script für Google Kalender
  • Google Workspace-Schulungscenter

Google Cloud-Schulungen und -Zertifizierungen

In unseren Schulungen erfahren Sie alles zum optimalen Einsatz unserer Google Cloud-Technologien und können sich entsprechend zertifizieren lassen. Unsere Kurse vermitteln technische Fähigkeiten und Best Practices, damit Sie möglichst schnell mit Google Cloud loslegen und Ihr Wissen fortlaufend erweitern können. Wir bieten On-Demand-, Präsenz- und virtuelle Schulungen für Anfänger wie Fortgeschrittene an, die Sie individuell in Ihrem eigenen Zeitplan absolvieren können. Mit unseren Zertifizierungen weisen Sie nach, dass Sie Experte im Bereich Google Cloud-Technologien sind.

Anleitung zuletzt aktualisiert am 18. August 2025

Lab zuletzt getestet am 18. August 2025

© 2026 Google LLC. Alle Rechte vorbehalten. Google und das Google-Logo sind Marken von Google LLC. Alle anderen Unternehmens- und Produktnamen können Marken der jeweils mit ihnen verbundenen Unternehmen sein.