Google Apps Script Chat-App

Erstelle eine Google Chat-App, über die du direkt Nachrichten senden und antworten kannst, indem du auf deine Nachrichten zurückgreifst.

Zielsetzungen

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

Voraussetzungen

Umgebung einrichten

Richten Sie Ihre Umgebung ein, um diese Kurzanleitung abzuschließen.

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-Überprüfern angezeigt wird. Außerdem wird Ihre App registriert, damit 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. Wenn Sie eine Anwendung erstellen, die außerhalb Ihrer Google Workspace-Organisation verwendet werden kann, klicken Sie auf Bereiche hinzufügen oder entfernen. Fügen Sie die für Ihre Anwendung erforderlichen Autorisierungsbereiche hinzu und prüfen Sie sie. Klicken Sie dann auf Speichern und fortfahren.

    Für einige Bereiche sind zusätzliche Prüfungen durch Google erforderlich. Für Apps, die nur intern von Ihrer Google Workspace-Organisation verwendet werden, sind Bereiche auf dem Zustimmungsbildschirm nicht aufgeführt und die Verwendung von eingeschränkten oder sensiblen Bereichen erfordert keine weitere Überprüfung durch Google. Weitere Informationen finden Sie unter Bereiche für Ihre Anwendung auswählen.

  5. Klicken Sie unter „Testnutzer“ auf Nutzer hinzufügen.
  6. Geben Sie Ihre E-Mail-Adresse und alle anderen autorisierten Testnutzer ein und klicken Sie dann auf Speichern und fortfahren.
  7. Sehen Sie sich die Zusammenfassung Ihrer App-Registrierung an. Klicken Sie auf Bearbeiten, um Änderungen vorzunehmen. Wenn die App-Registrierung in Ordnung ist, klicken Sie auf Zurück zum Dashboard.

Skript erstellen

Zum Erstellen 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 Seite mit den ersten Schritten 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 die Google Cloud Console auf.
  2. Öffnen Sie gegebenenfalls das Cloud-Projekt, das Sie für diese Kurzanleitung verwenden möchten:
    1. Klicken Sie neben „Google Cloud“ auf den Abwärtspfeil . Ein Dialogfeld mit den aktuellen Projekten wird angezeigt.
    2. Wählen Sie Ihr Projekt aus und klicken Sie auf Öffnen. Die Konsole öffnet Ihr Projekt.
  3. Klicken Sie auf „Einstellungen und Dienstprogramme“ > Projekteinstellungen.
  4. Kopieren Sie die Projektnummer.

Cloud-Projekt für 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) auf Projekt ändern.
  3. Fügen 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 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 dies bemerken.

Bereitstellungs-ID abrufen

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

So rufen Sie die Bereitstellungs-ID ab:

  1. Klicken Sie im Apps Script-Projekt der Chat App auf Bereitstellen > Neue Bereitstellung.
  2. Klicken Sie unter „Typ auswählen“ auf Add-on.
  3. Füllen Sie die Optionen aus und klicken Sie auf Bereitstellen.
  4. Klicken Sie unter „Bereitstellungs-ID“ auf Kopieren.

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

Die Chat App ist zum Beantworten von Nachrichten bereit.

Beispiel ausführen

  1. Öffnen Sie Google Chat.
  2. Senden Sie eine neue Direktnachricht an die App. Klicken Sie dazu auf Chat starten .
  3. Suchen Sie auf der Seite "Apps suchen" nach "Kurzanleitungs-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 definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media-Elemente wie Bilder. Mit Kartennachrichten können Sie detaillierte Informationen präsentieren, Informationen von Nutzern sammeln und Nutzer zu den nächsten Schritten leiten.
  • Unterstützen Sie Slash-Befehle. 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 öffnen. Dialogfelder sind kartenbasierte Schnittstellen im Fenstermodus, die Ihre App öffnen kann, um mit einem Nutzer zu interagieren. Mehrere Karten lassen sich nacheinander zusammenfassen, sodass Nutzer mehrstufige Prozesse ausführen können, z. B. Formulardaten eingeben.