Kurzanleitung für die Google Apps Script Chat App

Erstellen Sie eine Google Chat-App, an die Sie direkt Nachrichten senden und die durch Nachrichten reagieren kann.

Zielsetzungen

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

Vorbereitung

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:

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

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

  1. Gehen Sie in der Google Cloud Console zum Menü > APIs & Dienste > OAuth-Zustimmungsbildschirm.

    Zum OAuth-Zustimmungsbildschirm

  2. Wählen Sie den Nutzertyp für Ihre App aus und klicken Sie auf Erstellen.
  3. Füllen Sie das App-Registrierungsformular aus und klicken Sie auf Speichern und fortfahren.
  4. Überspringen Sie vorerst das Hinzufügen von Bereichen und klicken Sie auf Speichern und fortfahren. 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.

  5. 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 anderen autorisierten Testnutzer ein und klicken Sie dann auf Speichern und fortfahren.
  6. Sehen Sie sich die Zusammenfassung Ihrer App-Registrierung an. Klicken Sie auf Bearbeiten, um Änderungen vorzunehmen. Wenn die App-Registrierung in Ordnung ist, klicke auf Zurück zum Dashboard.

Skript einrichten

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

Skript aus der Vorlage erstellen

  1. Rufen Sie die Seite Erste Schritte für Apps Script auf.
  2. Klicken Sie auf die Vorlage Chat App. Möglicherweise müssen Sie nach unten scrollen, um diese Vorlage zu sehen.
  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 Ihr Cloud-Projekt auf.
  2. Klicken Sie auf „Einstellungen und Dienstprogramme“ > Projekteinstellungen.
  3. Kopieren Sie die Projektnummer.

Cloud-Projekt im Apps Script-Projekt festlegen

  1. Klicken Sie im Apps Script-Projekt der Chat-App auf Projekteinstellungen Das Symbol für Projekteinstellungen.
  2. Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
  3. Geben Sie unter GCP-Projektnummer die Google Cloud-Projektnummer ein.
  4. Klicken Sie auf Projekt festlegen.

Sie haben jetzt funktionierenden Anwendungscode, den Sie ausprobieren können (wie in den folgenden Schritten beschrieben) und anschließend an Ihre 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 es 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 der Head-Bereitstellung ab:

  1. Klicken Sie im Apps Script-Projekt der Chat-App auf Bereitstellen > Bereitstellungen testen.
  2. Kopieren Sie die Head-Deployment-ID für die 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.

  1. Suchen Sie in der Google Cloud Console 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 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 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.
  4. Klicken Sie auf Speichern und aktualisieren Sie die Seite.

  5. Legen Sie auf der Konfigurationsseite unter App-Status den Status auf Live – für Nutzer verfügbar fest.

  6. Klicken Sie auf Speichern.

Die Chat App kann jetzt Nachrichten beantworten.

Skript ausführen

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

Vielen Dank, dass Sie die App hinzugefügt haben.

Nächste Schritte

  • Interaktive Karten erstellen: Kartennachrichten unterstützen ein festgelegtes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Verwenden Sie Kartennachrichten, um detaillierte Informationen zu präsentieren, Informationen von Nutzern zu erfassen und Nutzer zu einem nächsten Schritt zu leiten.
  • Unterstützung von Slash-Befehlen: Mit Slash-Befehlen können Sie bestimmte Befehle registrieren und bewerben, die Nutzer Ihrer App geben können, indem sie einen Befehl eingeben, 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 Infokarten können nacheinander aneinandergefügt werden, sodass Nutzer mehrstufige Prozesse wie das Ausfüllen von Formulardaten ausführen können.