Hast du 5 Minuten Zeit? Nehmen Sie an dieser kurzen Umfrage teil und helfen Sie uns, die Dokumentation für Google Chat-Entwickler zu verbessern.

Diese Seite wurde von der Cloud Translation API übersetzt.

Switch to English

Kurzanleitung für die Google Apps Script Chat App

Erstellen Sie eine Google Chat-App, mit der Sie Nachrichten direkt senden können und die mit einem Echo von Nachrichten antwortet.

Zielsetzungen

die Umgebung einrichten
Richten Sie das Skript ein.
Veröffentlichen Sie die App.
Führen Sie das Skript aus.

Voraussetzungen

Ein Google Workspace-Konto mit Zugriff auf Chat.
Ein Google Cloud-Projekt

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 noch nicht geschehen:

Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.
Cloud-Projekt auswählen
Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Alternativ können Sie auf Projekt erstellen klicken und der Anleitung auf dem Bildschirm folgen. 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 ein Zustimmungsbildschirm erforderlich. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer Anwendung konfigurieren, wird definiert, was Nutzern und Prüfern angezeigt wird. Außerdem wird die Anwendung registriert, damit Sie sie später veröffentlichen können.

Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm.
Zum OAuth-Zustimmungsbildschirm
Wählen Sie den Nutzertyp für Ihre Anwendung aus und klicken Sie 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 für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, müssen Sie die für die Anwendung erforderlichen Autorisierungsbereiche hinzufügen und prüfen.
Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
1. Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
2. Geben Sie Ihre E-Mail-Adresse und alle weiteren autorisierten Testnutzer ein und klicken Sie dann auf Speichern und fortfahren.
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

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

Skript aus der Vorlage erstellen

Rufen Sie die Apps Script-Seite Erste Schritte auf.
Klicken Sie auf die Vorlage Chat App. Möglicherweise 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

Rufen Sie Ihr Cloud-Projekt in der Google Cloud Console auf.
Klicken Sie auf „Einstellungen und Dienstprogramme“ > Projekteinstellungen.
Kopieren Sie die 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 darauf, dass Sie im richtigen Google-Konto angemeldet sind, wenn Sie die Apps Script-Vorlage öffnen. Das aktuelle Konto kann manchmal zu Ihrem Standardkonto wechseln, ohne dass Sie es merken.

Testbereitstellung erstellen

Sie benötigen eine Bereitstellungs-ID für dieses Apps Script-Projekt, 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.
Klicken Sie auf Verwalten.
Klicken Sie auf Konfiguration und richten Sie die Chat-App ein:
1. Geben Sie im Feld App-Name den Wert 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 „Funktionen“ die Option 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
5. Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus und fügen Sie die Bereitstellungs-ID in das Feld ein.
6. Wählen Sie unter „Berechtigungen“ die Option Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E-Mail-Adresse ein.
Klicken Sie auf Speichern und aktualisieren Sie die Seite.
Legen Sie auf der Konfigurationsseite unter Anwendungsstatus den Status auf Live – für Nutzer verfügbar fest.
Klicken Sie auf Speichern.

Die Google Chat App kann jetzt auf Nachrichten antworten.

Skript ausführen

Öffnen Sie Google Chat.
Senden Sie eine neue Direktnachricht an die App, indem Sie auf Chat starten > Apps suchen klicken.
Suchen Sie auf der Seite „Apps suchen“ nach Quickstart App.
Klicken Sie neben Schnellstart-App auf Chat.
Geben Sie in der neuen Direktnachricht an die App Hello ein und drücken Sie enter.

Die App bedankt sich bei Ihnen und gibt Ihre Nachricht wieder.

Nächste Schritte

Interaktive Karten erstellen: Kartenmeldungen unterstützen ein definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Kartennachrichten verwenden, um detaillierte Informationen zu präsentieren, Informationen von Nutzern zu erfassen 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 App geben können. Dazu geben Sie einen Befehl ein, der mit einem Schrägstrich (/) beginnt, z. B. /help.
Dialogfelder starten: Dialoge sind kartenbasierte Benutzeroberflächen im Fenstermodus, die Ihre Anwendung ö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 abzuschließen.