Zum Inhalt

Google Calendar-Integration

Ihrer Installation von Drovio Server kann eine Google Calendar-Integration hinzugefügt werden. Sie erlaubt Benutzern, Drovio-Meetings direkt aus Google Calendar heraus zu planen: Drovio meeting in den Videokonferenzoptionen eines Termins erstellt das Meeting mit Datum und Uhrzeit des Termins und fügt den Link zum Beitreten in diesen ein. Beim Speichern von Änderungen am Termin wird das Meeting an dessen Datum, Betreff, Beschreibung, Teilnehmer und Serienmuster angeglichen; das Absagen des Termins oder die Wahl einer anderen Videokonferenzoption löscht das Meeting. Drovio verschickt keine eigene Einladung: Die Teilnehmer erhalten die Einladung von Google Calendar.

Das Add-on meldet seine Benutzer mit ihrem Google-Konto an: Beim ersten Mal melden sie sich außerdem einmalig bei Ihrer Instanz von Drovio Server an, um beide Konten zu verknüpfen. Ihr Drovio-Konto muss bereits existieren.

Die Integration erlaubt den Benutzern der Drovio App außerdem, über deren Kalender-Schaltfläche ein Meeting mit Google Calendar zu planen, mit oder ohne Add-on: siehe Aus der Drovio App planen.

Nur HTTPS

Google ruft das Add-on auf Ihrem Server ausschließlich über HTTPS auf. Ihr Drovio Server muss aus dem Internet über HTTPS erreichbar sein.

Das Add-on in Ihrem Google Workspace bereitstellen

Der öffentliche Eintrag von Drovio im Google Workspace Marketplace bedient nur die Drovio-Cloud. Ihr Server erhält ein eigenes Add-on, das Ihr Google Workspace privat veröffentlicht und dessen Administrator es für alle installiert: Die Benutzer müssen es dann nur noch verbinden. Die Seite Google Calendar der Administrationsoberfläche führt Sie durch diese Schritte: Öffnen Sie Integrations, dann Configure auf der Karte Google Calendar.

Sie benötigen ein Administratorkonto von Google Workspace, die Google Cloud CLI und ein Google Cloud-Projekt für das Add-on.

Das Google Cloud-Projekt erstellen

Das Projekt kann über die Google Cloud console, die Google Cloud CLI oder Terraform erstellt werden. Alle drei führen zum selben Ergebnis: ein Projekt, in dem die drei APIs aktiviert sind, die das Add-on benötigt.

API Dienst Wofür
Google Workspace add-ons API gsuiteaddons.googleapis.com Stellt das Add-on bereit
Google Calendar API calendar-json.googleapis.com Erlaubt Ihrem Server, die Termine zu lesen, denen das Add-on folgt
Google Workspace Marketplace SDK appsmarket-component.googleapis.com Veröffentlicht den Eintrag, über den Benutzer das Add-on installieren

Erstellen Sie in der Google Cloud console ein Projekt in der Organisation Ihres Google Workspace. Suchen und aktivieren Sie dann unter APIs & Services und Library die drei oben genannten APIs.

Wählen Sie die ID des Projekts, die in ganz Google Cloud frei sein muss, und ermitteln Sie dann die ID der Organisation Ihres Google Workspace:

PROJECT=drovio-calendar
gcloud organizations list
ORGANIZATION=<the ID the command prints>

Erstellen Sie das Projekt, aktivieren Sie seine APIs und machen Sie es zum aktuellen Projekt der Google Cloud CLI, mit dem die Befehle der nächsten Schritte arbeiten:

gcloud projects create "$PROJECT" --name="Drovio Calendar" --organization="$ORGANIZATION"

gcloud services enable --project="$PROJECT" \
  gsuiteaddons.googleapis.com \
  calendar-json.googleapis.com \
  appsmarket-component.googleapis.com

gcloud config set project "$PROJECT"

Dasselbe Projekt für eine Infrastruktur, die bereits als Code beschrieben ist, mit dem Provider google. Die folgenden Dateien bilden ein einziges Root-Modul.

terraform {
  required_version = ">= 1.5.0, < 2.0.0"

  required_providers {
    google = {
      source  = "hashicorp/google"
      version = ">= 5.0"
    }
  }
}
variable "project_id" {
  description = "ID of the project of the add-on, free across Google Cloud"
  type        = string
  default     = "drovio-calendar"
}

variable "org_id" {
  description = "ID of the organization of the Google Workspace, which gcloud organizations list prints"
  type        = string
}
# The listing of the add-on is bound to the number of this project
resource "google_project" "calendar" {
  name       = "Drovio Calendar"
  project_id = var.project_id
  org_id     = var.org_id

  lifecycle {
    prevent_destroy = true
  }
}

resource "google_project_service" "calendar" {
  project = google_project.calendar.project_id
  for_each = toset([
    "appsmarket-component.googleapis.com",
    "calendar-json.googleapis.com",
    "gsuiteaddons.googleapis.com",
  ])
  service = each.key

  disable_dependent_services = true
}
output "project_id" {
  description = "ID of the project, the current project of the Google Cloud CLI for the next steps"
  value       = google_project.calendar.project_id
}

Machen Sie es dann zum aktuellen Projekt der Google Cloud CLI, mit dem die Befehle der nächsten Schritte arbeiten:

gcloud config set project "$(terraform output -raw project_id)"

Terraform endet beim Projekt: Google bietet keine Ressource für den OAuth-Zustimmungsbildschirm, die Bereitstellung des Add-ons oder seinen Eintrag, die die nächsten Schritte erstellen.

Die Absicherung prevent_destroy bewahrt das Projekt: Der Eintrag ist an dessen Nummer gebunden, und ein Projekt, das gelöscht und unter derselben ID neu erstellt wird, erhält eine andere Nummer, was die Veröffentlichung eines neuen Eintrags bedeutet.

Den OAuth-Zustimmungsbildschirm einrichten

Google bietet dafür keinen Befehl: Richten Sie ihn in der Google Cloud console unter APIs & Services und OAuth consent screen mit der Zielgruppe Internal ein, die das Add-on auf die Benutzer Ihres Google Workspace beschränkt.

Die Bereitstellung erstellen

Laden Sie im Abschnitt Private deployment der Administrationsoberfläche die Bereitstellung herunter: Sie beschreibt das Add-on und verweist auf Ihren Server. Führen Sie dann, mit dem oben erstellten Projekt als aktuellem Projekt der Google Cloud CLI, Folgendes aus:

gcloud workspace-add-ons get-authorization
gcloud workspace-add-ons deployments create drovio --deployment-file=drovio-google-calendar-deployment.json
gcloud workspace-add-ons deployments install drovio

Der erste Befehl gibt das Dienstkonto aus, als das Google das Add-on aufruft. Fügen Sie es unter Service account ein und speichern Sie dann.

Die Google Cloud CLI ist der einzige Weg, die Bereitstellung zu erstellen: Die Google Cloud console hat keine Seite dafür und Terraform keine Ressource.

Den privaten Eintrag veröffentlichen

Konfigurieren Sie im Google Cloud-Projekt das Google Workspace Marketplace SDK, das mit dem oben erstellten Projekt aktiviert wurde:

Einstellung Wert
App visibility Private
Installation settings Admin Only Install
App integration Google Workspace add-on, HTTP or other deployments, dann die Bereitstellung drovio auswählen
Store listing Ausfüllen: Name, Beschreibungen, Logos, Links

Veröffentlichen Sie den Eintrag und installieren Sie die App dann über die Google Admin console für Ihre Domain. Fügen Sie die URL des Eintrags unter Marketplace listing ein und speichern Sie dann.

Die Integration konfigurieren

Öffnen Sie in der Administrationsoberfläche Integrations, dann Configure auf der Karte Google Calendar.

Feld Woher es kommt
Status Enabled oder Disabled
Marketplace listing Die URL des privaten Eintrags, den Ihr Google Workspace veröffentlicht hat
Service account Die E-Mail-Adresse, die gcloud workspace-add-ons get-authorization ausgibt

Die Seite zeigt außerdem an, wie viele Benutzer sich angemeldet haben. Das Speichern wirkt ab dem nächsten Aufruf, ohne Neustart. Den Status auf Disabled zu setzen weist die Anfragen von Google ab, lässt die Seite aber weiterhin zugänglich, um die Integration zu konfigurieren.

Konfigurationsreferenz

Dies sind die Schlüssel des Elements google_calendar in settings.conf, falls Sie es lieber direkt bearbeiten. In einem Cluster kann die Administrationsoberfläche sie nicht speichern: Jeder Server liest seine eigene Konfigurationsdatei, die auf jedem einzelnen von ihnen bearbeitet werden muss.

Schlüssel Standard Bedeutung
enabled false Aktiviert die Integration
listing_url URL des Eintrags, über den Benutzer das Add-on installieren
service_account_email Dienstkonto der Bereitstellung, als das Google das Add-on aufruft
meeting_scheduling true Bietet Google Calendar in der Kalender-Schaltfläche der Drovio App an, solange die Integration aktiviert ist

Das Add-on verwenden

Sobald das Add-on für die Domain installiert ist, zeigt Google Calendar Drovio in der Seitenleiste und in den Videokonferenzoptionen der Termine an:

Wo Funktion
Drovio meeting, in den Videokonferenzoptionen eines Termins Erstellt das Drovio-Meeting des Termins und fügt dessen Link zum Beitreten in den Termin ein
Die Drovio-Karte, in der Seitenleiste Verknüpft das Google-Konto des Benutzers mit seinem Drovio-Konto, zeigt das Drovio-Konto an, bei dem das Add-on angemeldet ist, und erlaubt dem Benutzer, die Verbindung zu trennen

Änderungen an einem Termin erreichen sein Drovio-Meeting, sobald der Termin gespeichert ist.

Das Drovio-Konto verknüpfen

Beim ersten Mal öffnet das Add-on ein Fenster auf Ihrer Instanz von Drovio Server, um das Google-Konto des Benutzers mit seinem Drovio-Konto zu verknüpfen:

  • ein Benutzer, der in seinem Browser bereits bei Drovio angemeldet ist, wird gebeten, das zu verknüpfende Konto mit Connect zu bestätigen;
  • jeder andere Benutzer meldet sich zuerst an und bestätigt dann. Die Anmeldeseite ist die Ihres Servers oder ein Formular der Integration, wenn Ihr Server keine hat.

Die Verknüpfung besteht, bis der Benutzer sie über die Drovio-Karte der Seitenleiste trennt. Sie muss innerhalb einer Viertelstunde nach dem Öffnen des Fensters abgeschlossen werden.

Nie gespeicherte Termine

Das Add-on erstellt das Drovio-Meeting, sobald Drovio meeting gewählt wird, während Google nichts über einen Termin mitteilt, der ohne Speichern geschlossen wird. Einen Tag später, wenn der Benutzer das nächste Mal die Drovio-Karte öffnet oder seinen Kalender ändert, prüft das Add-on den Termin bei Google und löscht das Meeting eines Termins, der nie gespeichert wurde oder ohne das Meeting gespeichert wurde.

Aus der Drovio App planen

Solange die Integration aktiviert und meeting_scheduling eingeschaltet ist, bietet die Kalender-Schaltfläche der Drovio App Google Calendar an. Was sich bei dieser Wahl öffnet, hängt vom Benutzer ab:

  • ein Benutzer, der das Add-on verknüpft hat, erhält einen neuen Termin in Google Calendar, in dem er in den Videokonferenzoptionen Drovio meeting wählt: Das Add-on erstellt das Meeting und gleicht es weiterhin an den Termin an;
  • für jeden anderen Benutzer wird ein Drovio-Meeting erstellt und dann ein neuer Termin geöffnet, ausgefüllt mit dem Link zum Beitreten, als Ort und in der Beschreibung. Betreff und Beschreibung sind in der Sprache des Drovio-Kontos des Benutzers verfasst. Das Meeting beginnt, wenn der Benutzer Google Calendar auswählt, und dauert eine Stunde, da Ihr Server nicht erfährt, wann der Termin stattfindet; über seinen Link kann man ihm jederzeit beitreten.

Die App zeigt die Kalender-Schaltfläche ab Drovio App 3.7.1 an, mit den Planungsmöglichkeiten, die die Integrationen Ihres Servers anbieten: Bei keiner wird sie ausgeblendet, bei einer öffnet sie diese direkt, bei mehreren öffnet sie ein Menü. Siehe Drovio App.