Diese Seite wurde von der Cloud Translation API übersetzt.

Kurzanleitung für die Google Apps Script Chat App

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

Zielsetzungen

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

Vorbereitung

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. Sie können auch 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 eine Konfiguration des Zustimmungsbildschirms erforderlich. Wenn Sie den OAuth-Zustimmungsbildschirm der App konfigurieren, wird festgelegt, was Nutzern und App-Prüfern angezeigt wird, und Ihre App wird registriert, damit Sie sie später veröffentlichen können.

Gehen Sie in der Google Cloud Console zu „Menü“ > APIs und Dienste > OAuth-Zustimmungsbildschirm.
Zum OAuth-Zustimmungsbildschirm
Wählen Sie den Nutzertyp für Ihre App aus und klicken Sie auf Erstellen.
Füllen Sie das Formular zur App-Registrierung aus und klicken Sie auf Speichern und fortfahren.
Sie können 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 Ihre 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 Nutzer testen auf Nutzer hinzufügen.
2. Geben Sie Ihre E-Mail-Adresse und alle anderen autorisierten Testnutzer ein und klicken Sie auf Speichern und fortfahren.
Sehen Sie sich die Zusammenfassung Ihrer App-Registrierung an. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Bearbeiten. Wenn die Registrierung der App 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 Seite Erste Schritte für Apps Script auf.
Klicken Sie auf die Vorlage Chat App. Sie müssen möglicherweise 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 in der Google Cloud Console Ihr Cloud-Projekt 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 (GCP) Project auf Projekt ändern.
Fügen Sie unter GCP-Projektnummer die Google Cloud-Projektnummer ein.
Klicken Sie auf Projekt festlegen.

Sie haben jetzt funktionsfähigen Anwendungscode, den Sie wie in den folgenden Schritten beschrieben testen können. Anschließend können Sie den Code entsprechend Ihren Anforderungen anpassen.

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 dies bemerken.

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 für die Head-Bereitstellung ab:

Klicken Sie im Apps Script-Projekt der Chat App auf Bereitstellen > Bereitstellungen testen.
Kopieren Sie die Head-Deployment-ID, um sie in einem späteren Schritt zu verwenden, 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 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 „Funktionalität“ die Option 1:1-Nachrichten empfangen und Gruppenbereich 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 App-Status den Status auf Live – für Nutzer verfügbar fest.
Klicken Sie auf Speichern.

Die Chat App ist bereit, auf Nachrichten zu antworten.

Skript ausführen

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

Danke, dass Sie die App hinzugefügt haben.

Nächste Schritte

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 fensterbasierte, kartenbasierte Schnittstellen, 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.