Vai al contenuto

Integrazione Google Calendar

Un'integrazione Google Calendar può essere aggiunta alla vostra installazione di Drovio Server. Permette agli utenti di pianificare riunioni Drovio direttamente da Google Calendar: Drovio meeting tra le opzioni di videoconferenza di un evento crea la riunione, con le date dell'evento, e vi inserisce il link per partecipare. Il salvataggio delle modifiche all'evento mantiene la riunione allineata con le sue date, il suo oggetto, la sua descrizione, i suoi partecipanti e la sua ricorrenza; annullare l'evento, o scegliere un'altra opzione di videoconferenza, elimina la riunione. Drovio non invia alcun invito proprio: l'invito di Google Calendar è quello che ricevono i partecipanti.

Il componente aggiuntivo autentica i suoi utenti con il loro account Google: la prima volta, si autenticano anche una volta sulla vostra istanza di Drovio Server, per collegare i due account. Il loro account Drovio deve già esistere.

L'integrazione permette anche agli utenti dell'applicazione Drovio di pianificare una riunione con Google Calendar dal suo pulsante calendario, con o senza il componente aggiuntivo: consultate Pianificare dall'applicazione Drovio.

Solo HTTPS

Google chiama il componente aggiuntivo sul vostro server soltanto in HTTPS. Il vostro Drovio Server deve essere raggiungibile in HTTPS da Internet.

Distribuire il componente aggiuntivo nel vostro Google Workspace

La scheda pubblica di Drovio nel Google Workspace Marketplace serve soltanto il cloud Drovio. Il vostro server riceve un componente aggiuntivo proprio, che il vostro Google Workspace pubblica in modo privato e che il suo amministratore installa per tutti: gli utenti devono poi soltanto connetterlo. La pagina Google Calendar del pannello di amministrazione vi guida passo per passo: aprite Integrations, poi Configure sulla scheda Google Calendar.

Avrete bisogno di un account amministratore di Google Workspace, della Google Cloud CLI e di un progetto Google Cloud per il componente aggiuntivo.

Creare il progetto Google Cloud

Il progetto può essere creato dalla console Google Cloud, dalla Google Cloud CLI o da Terraform. I tre metodi portano allo stesso risultato: un progetto con attivate le tre API di cui ha bisogno il componente aggiuntivo.

API Servizio A cosa serve
Google Workspace add-ons API gsuiteaddons.googleapis.com Distribuisce il componente aggiuntivo
Google Calendar API calendar-json.googleapis.com Permette al vostro server di leggere gli eventi che il componente aggiuntivo segue
Google Workspace Marketplace SDK appsmarket-component.googleapis.com Pubblica la scheda da cui gli utenti installano il componente aggiuntivo

Nella console Google Cloud, create un progetto nell'organizzazione del vostro Google Workspace. Poi, sotto APIs & Services e Library, cercate e attivate le tre API qui sopra.

Scegliete l'ID del progetto, che deve essere libero su tutto Google Cloud, poi trovate l'ID dell'organizzazione del vostro Google Workspace:

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

Create il progetto, attivatene le API, e rendetelo il progetto corrente della Google Cloud CLI, su cui lavorano i comandi dei passaggi successivi:

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"

Lo stesso progetto, per un'infrastruttura già descritta sotto forma di codice, con il provider google. I file qui sotto formano un unico modulo radice.

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
}

Rendetelo poi il progetto corrente della Google Cloud CLI, su cui lavorano i comandi dei passaggi successivi:

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

Terraform si ferma al progetto: Google non offre alcuna risorsa per la schermata di consenso OAuth, per la distribuzione del componente aggiuntivo o per la sua scheda, che vengono creati nei passaggi successivi.

La protezione prevent_destroy conserva il progetto: la scheda è legata al suo numero, e un progetto eliminato e poi ricreato con lo stesso ID ne riceve un altro, il che significa pubblicare una nuova scheda.

Configurare la schermata di consenso OAuth

Google non offre alcun comando per farlo: nella console Google Cloud, sotto APIs & Services e OAuth consent screen, configuratela con il pubblico Internal, che riserva il componente aggiuntivo agli utenti del vostro Google Workspace.

Creare la distribuzione

Nella sezione Private deployment del pannello di amministrazione, scaricate la distribuzione: descrive il componente aggiuntivo e punta al vostro server. Poi eseguite, con il progetto qui sopra come progetto corrente della Google Cloud CLI:

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

Il primo comando mostra il service account con cui Google chiama il componente aggiuntivo. Incollatelo in Service account, poi salvate.

La Google Cloud CLI è l'unico modo per creare la distribuzione: la console Google Cloud non ha alcuna pagina per farlo, e Terraform alcuna risorsa.

Pubblicare la scheda privata

Nel progetto Google Cloud, configurate il Google Workspace Marketplace SDK, attivato con il progetto qui sopra:

Impostazione Valore
App visibility Private
Installation settings Admin Only Install
App integration Google Workspace add-on, HTTP or other deployments, poi selezionate la distribuzione drovio
Store listing Compilatela: nome, descrizioni, loghi, link

Pubblicate la scheda, poi installate l'applicazione per il vostro dominio dalla Google Admin console. Incollate l'URL della scheda in Marketplace listing, poi salvate.

Configurare l'integrazione

Nel pannello di amministrazione, aprite Integrations, poi Configure sulla scheda Google Calendar.

Campo Da dove viene
Status Enabled o Disabled
Marketplace listing L'URL della scheda privata pubblicata dal vostro Google Workspace
Service account L'email mostrata da gcloud workspace-add-ons get-authorization

La pagina mostra anche quanti utenti si sono connessi. Il salvataggio ha effetto già dalla richiesta successiva, senza riavvio. Passare lo stato a Disabled rifiuta le richieste provenienti da Google, lasciando comunque accessibile la pagina per configurare l'integrazione.

Riferimento di configurazione

Ecco le chiavi dell'elemento google_calendar di settings.conf, se preferite modificarlo direttamente. In un cluster, il pannello di amministrazione non può salvarle: ogni server legge il proprio file di configurazione, che va modificato su ciascuno di essi.

Chiave Predefinito Significato
enabled false Attiva l'integrazione
listing_url URL della scheda da cui gli utenti installano il componente aggiuntivo
service_account_email Service account della distribuzione, con cui Google chiama il componente aggiuntivo
meeting_scheduling true Propone Google Calendar nel pulsante calendario dell'applicazione Drovio, finché l'integrazione è attiva

Usare il componente aggiuntivo

Una volta installato il componente aggiuntivo per il dominio, Google Calendar mostra Drovio nel pannello laterale e tra le opzioni di videoconferenza degli eventi:

Dove Cosa fa
Drovio meeting, tra le opzioni di videoconferenza di un evento Crea la riunione Drovio dell'evento e inserisce nell'evento il suo link per partecipare
La scheda Drovio, nel pannello laterale Collega l'account Google dell'utente al suo account Drovio, mostra l'account Drovio a cui è collegato il componente aggiuntivo e permette all'utente di scollegarlo

Le modifiche a un evento raggiungono la sua riunione Drovio una volta salvato l'evento.

Collegare l'account Drovio

La prima volta, il componente aggiuntivo apre una finestra sulla vostra istanza di Drovio Server per collegare l'account Google dell'utente al suo account Drovio:

  • a un utente già connesso a Drovio nel proprio browser viene chiesto di confermare l'account da collegare, con Connect;
  • qualsiasi altro utente si autentica prima, poi conferma. La pagina di accesso è quella del vostro server, oppure un modulo dell'integrazione quando il vostro server non ne ha.

Il collegamento resta valido finché l'utente non lo scollega, dalla scheda Drovio del pannello laterale. Deve essere completato entro un quarto d'ora dall'apertura della finestra.

Eventi mai salvati

Il componente aggiuntivo crea la riunione Drovio non appena viene scelto Drovio meeting, mentre Google non dice nulla di un evento chiuso senza essere salvato. Un giorno dopo, la volta successiva in cui l'utente apre la scheda Drovio o modifica il proprio calendario, il componente aggiuntivo verifica l'evento presso Google ed elimina la riunione di un evento che non è mai stato salvato, o che è stato salvato senza di essa.

Pianificare dall'applicazione Drovio

Finché l'integrazione è attiva e meeting_scheduling è attivato, il pulsante calendario dell'applicazione Drovio propone Google Calendar. Ciò che si apre scegliendolo dipende dall'utente:

  • un utente che ha collegato il componente aggiuntivo ottiene un nuovo evento di Google Calendar, in cui sceglie Drovio meeting tra le opzioni di videoconferenza: il componente aggiuntivo crea la riunione e la mantiene allineata con l'evento;
  • qualsiasi altro utente ottiene una riunione Drovio creata per lui, poi un nuovo evento compilato con il suo link per partecipare, come luogo e nella descrizione. L'oggetto e la descrizione sono scritti nella lingua dell'account Drovio dell'utente. La riunione inizia nel momento in cui l'utente sceglie Google Calendar e dura un'ora, poiché nulla dice al vostro server quando si svolge l'evento; il suo link permette di raggiungerla in qualsiasi momento.

L'applicazione mostra il pulsante calendario dalla versione 3.7.1 dell'applicazione Drovio, con i mezzi di pianificazione offerti dalle integrazioni del vostro server: nessuno lo nasconde, uno lo apre direttamente, più di uno aprono un menu. Consultate Applicazione Drovio.