Programmierstufe: Mittel
Dauer: 25 Minuten
Projekttyp: Google Chat App
Zielsetzungen
- Verstehen Sie, was die Lösung leisten kann.
- Was die Apps Script-Dienste innerhalb der Lösung leisten
- die Umgebung einrichten
- Richten Sie das Skript ein.
- Führen Sie das Skript aus.
Informationen zu dieser Lösung
Sie können eine Besprechung in Google Kalender über eine Direktnachricht (DM) oder einen Gruppenbereich in Google Chat planen. Sie können bestimmte Details für die Videokonferenz festlegen, z. B. Betreff, Beginn oder Dauer, oder die Standardeinstellungen für die Planung von Videokonferenzen verwenden.
Funktionsweise
Im Script der Chat-App werden Slash-Befehle und Dialogfelder verwendet, um Besprechungsdetails von Nutzern abzurufen und einen Kalendertermin zu planen. Das Skript enthält Standardeinstellungen für Videokonferenzen, die an Ihre Anforderungen angepasst werden können.
Apps Script-Dienste
Diese Lösung verwendet die folgenden Dienste:
- Kalenderdienst: Erstellt den Kalendertermin aus den bereitgestellten Besprechungsinformationen.
- Basisdienst: Verwendet die Klasse
Session
, um die Zeitzone des Skripts abzurufen. Diese Zeitzone wird in Google Kalender für die Terminplanung verwendet. - Dienstprogramme: Formatiert das Datum für den Kalendertermin und codiert die Termin-ID, um die Termin-URL abzurufen.
Voraussetzungen
Sie benötigen die folgenden Voraussetzungen, um dieses Beispiel verwenden zu können:
- Ein Google-Konto (Google Workspace-Konten erfordern möglicherweise die Administratorgenehmigung).
- Ein Webbrowser mit Zugang zum Internet.
- Ein Google Cloud-Projekt
Umgebung einrichten
Cloud-Projekt in der Google Cloud Console öffnen
Falls noch nicht geschehen, öffnen Sie das Cloud-Projekt, das Sie für dieses Beispiel verwenden möchten:
- Rufen Sie in der Google Cloud Console die Seite Projekt auswählen auf.
- Wählen Sie das Google Cloud-Projekt aus, das Sie verwenden möchten. Oder klicken Sie auf Projekt erstellen und folgen Sie der Anleitung auf dem Bildschirm. Wenn Sie ein Google Cloud-Projekt erstellen, müssen Sie möglicherweise die Abrechnung für das Projekt aktivieren.
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 Ihrem Cloud-Projekt die Google Chat API.
OAuth-Zustimmungsbildschirm konfigurieren
Für alle Chat-Apps ist ein Zustimmungsbildschirm konfiguriert. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer Anwendung konfigurieren, legen Sie fest, was Google den Nutzern anzeigt. Außerdem wird die Anwendung registriert, damit Sie sie später veröffentlichen können.
- Rufen Sie in der Google Cloud Console das Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm. auf
- Wählen Sie für Nutzertyp die Option Intern aus und klicken Sie dann 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 außerhalb Ihrer Google Workspace-Organisation erstellen, müssen Sie den Nutzertyp in Extern ändern und dann die für die Anwendung erforderlichen Autorisierungsbereiche hinzufügen.
- 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
Apps Script-Projekt erstellen
- Klicken Sie auf die folgende Schaltfläche, um das Apps Script-Projekt Besprechungen über Google Chat planen zu öffnen.
Projekt öffnen - Klicke auf Übersicht .
- Klicken Sie auf der Übersichtsseite auf „Kopie erstellen“ .
Cloud-Projektnummer kopieren
- Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > IAM und Verwaltung > Einstellungen.
- Kopieren Sie den Wert im Feld Projektnummer.
Cloud-Projekt des Apps Script-Projekts festlegen
- Klicken Sie im kopierten Apps Script-Projekt 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.
Testbereitstellung erstellen
- Klicken Sie im kopierten Apps Script-Projekt auf Bereitstellen > Bereitstellungen testen.
- Kopieren Sie die Head-Deployment-ID zur Verwendung in einem späteren Schritt und klicken Sie auf Done (Fertig).
Chat API konfigurieren
- Rufen Sie in der Google Cloud Console die Seite Chat API auf.
Zur Chat API - Klicken Sie auf Konfiguration.
- Konfigurieren Sie die Chat API mit den folgenden Informationen:
- Name:
Meeting Scheduler
- Avatar-URL: Geben Sie eine URL ein, die auf ein Bild mit einer Mindestgröße von 256 × 256 Pixeln verweist.
- Description:
Quickly create meetings.
- Funktionalität: Klicken Sie beide Kästchen an, damit Nutzer direkt Nachrichten an die App senden und in Gruppenbereiche einfügen können.
- Verbindungseinstellungen: Klicken Sie auf Apps Script und geben Sie die Bereitstellungs-ID des Heads ein.
- Slash-Befehle: Fügen Sie mit den folgenden Schritten Slash-Befehle für
/help
und/schedule_Meeting
hinzu:- Klicken Sie auf Slash-Befehl hinzufügen und konfigurieren Sie ihn mit den folgenden Informationen:
- Name:
/help
- Befehls-ID:
1
- Description:
Learn what this app does.
- Name:
- Klicken Sie noch einmal auf Slash-Befehl hinzufügen und konfigurieren Sie ihn mit den folgenden Informationen:
- Name:
/schedule_Meeting
- Befehls-ID:
2
- Description:
Schedule a meeting.
- Klicken Sie auf das Kästchen Öffnet ein Dialogfeld.
- Name:
- Klicken Sie auf Slash-Befehl hinzufügen und konfigurieren Sie ihn mit den folgenden Informationen:
- Berechtigungen: Wählen Sie Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E-Mail-Adresse ein.
- Name:
- 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.
Skript ausführen
- Öffnen Sie Google Chat.
- Klicken Sie auf „Chat starten“ .
- Suchen Sie nach dem Namen der App:
Meeting Scheduler
. - Senden Sie eine erste Nachricht wie
hello
, um die Autorisierung aufzufordern. Wenn die App antwortet, klicken Sie auf Konfigurieren und autorisieren Sie die App. Wenn auf dem OAuth-Zustimmungsbildschirm die Warnung Diese App wurde nicht verifiziert angezeigt wird, wählen Sie Erweitert > Zu {Projektname} (unsicher) aus.
/schedule_Meeting
an die App senden.Geben Sie im Dialogfeld mindestens eine E-Mail-Adresse der eingeladenen Person ein. Sie können die anderen Felder aktualisieren oder die Standardeinträge verwenden.
Klicke auf Senden.
Klicken Sie auf Kalendertermin öffnen, um sich die Videokonferenz anzusehen.
Code ansehen
Klicken Sie unten auf Quellcode ansehen, um den Apps Script-Code für diese Lösung zu überprüfen:
Quellcode ansehen
Code.gs
Dialog.gs
Utilities.gs
Beitragende
Dieses Beispiel wird von Google mit Unterstützung von Google Developers-Experten verwaltet.