Saltar a contenido

Integración con Google Calendar

Puede añadir una integración con Google Calendar a su instalación de Drovio Server. Permite a los usuarios programar reuniones de Drovio directamente desde Google Calendar: Drovio meeting, en las opciones de videoconferencia de un evento, crea la reunión con las fechas del evento y coloca en él el enlace para unirse. Guardar los cambios del evento mantiene la reunión al día con sus fechas, su asunto, su descripción, sus asistentes y su periodicidad; cancelar el evento, o elegir otra opción de videoconferencia, elimina la reunión. Drovio no envía ninguna invitación propia: la invitación de Google Calendar es la que reciben los asistentes.

El complemento conecta a sus usuarios con su cuenta de Google: la primera vez, se conectan además una sola vez a su instancia de Drovio Server, para vincular ambas cuentas. Su cuenta de Drovio debe existir previamente.

La integración permite también a los usuarios de la aplicación Drovio programar una reunión con Google Calendar desde su botón de calendario, con o sin el complemento: consulte Programar desde la aplicación Drovio.

Solo HTTPS

Google solo llama al complemento en su servidor por HTTPS. Su Drovio Server debe ser accesible por HTTPS desde Internet.

Desplegar el complemento en su Google Workspace

La ficha pública de Drovio en Google Workspace Marketplace solo sirve a la nube de Drovio. Su servidor obtiene un complemento propio, que su Google Workspace publica de forma privada y que su administrador instala para todos: los usuarios solo tienen que conectarlo. La página Google Calendar del panel de administración le guía paso a paso: abra Integrations y luego Configure en la tarjeta Google Calendar.

Necesitará una cuenta de administrador de Google Workspace, la Google Cloud CLI y un proyecto de Google Cloud para el complemento.

Crear el proyecto de Google Cloud

El proyecto puede crearse desde la consola de Google Cloud, la Google Cloud CLI o Terraform. Las tres vías llevan al mismo resultado: un proyecto con las tres API que necesita el complemento activadas.

API Servicio Para qué
Google Workspace add-ons API gsuiteaddons.googleapis.com Despliega el complemento
Google Calendar API calendar-json.googleapis.com Permite a su servidor leer los eventos que sigue el complemento
Google Workspace Marketplace SDK appsmarket-component.googleapis.com Publica la ficha desde la que los usuarios instalan el complemento

En la consola de Google Cloud, cree un proyecto en la organización de su Google Workspace. Después, bajo APIs & Services y Library, busque y active las tres API anteriores.

Elija el ID del proyecto, que debe estar libre a escala de Google Cloud, y busque después el ID de la organización de su Google Workspace:

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

Cree el proyecto, active sus API, y conviértalo en el proyecto actual de la Google Cloud CLI, sobre el que actúan los comandos de los pasos siguientes:

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"

El mismo proyecto, para una infraestructura ya descrita en forma de código, con el proveedor google. Los archivos de abajo forman un solo módulo raíz.

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
}

Conviértalo después en el proyecto actual de la Google Cloud CLI, sobre el que actúan los comandos de los pasos siguientes:

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

Terraform se detiene en el proyecto: Google no ofrece ningún recurso para la pantalla de consentimiento OAuth, el despliegue del complemento ni su ficha, que crean los pasos siguientes.

La protección prevent_destroy conserva el proyecto: la ficha está ligada a su número, y un proyecto eliminado y creado de nuevo con el mismo ID recibe otro, lo que obliga a publicar una nueva ficha.

Configurar la pantalla de consentimiento OAuth

Google no ofrece ningún comando para ello: en la consola de Google Cloud, bajo APIs & Services y OAuth consent screen, configúrela con el público Internal, que reserva el complemento a los usuarios de su Google Workspace.

Crear el despliegue

En la sección Private deployment del panel de administración, descargue el despliegue: describe el complemento y apunta a su servidor. Ejecute después, con el proyecto anterior como proyecto actual de la 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

El primer comando muestra la cuenta de servicio con la que Google llama al complemento. Péguela en Service account y guarde.

La Google Cloud CLI es la única forma de crear el despliegue: la consola de Google Cloud no tiene ninguna página para ello, ni Terraform ningún recurso.

Publicar la ficha privada

En el proyecto de Google Cloud, configure el Google Workspace Marketplace SDK, activado con el proyecto anterior:

Ajuste Valor
App visibility Private
Installation settings Admin Only Install
App integration Google Workspace add-on, HTTP or other deployments, y luego seleccione el despliegue drovio
Store listing Rellénela: nombre, descripciones, logotipos, enlaces

Publique la ficha e instale después la aplicación para su dominio desde la Google Admin console. Pegue la URL de la ficha en Marketplace listing y guarde.

Configurar la integración

En el panel de administración, abra Integrations y luego Configure en la tarjeta Google Calendar.

Campo De dónde viene
Status Enabled o Disabled
Marketplace listing La URL de la ficha privada que ha publicado su Google Workspace
Service account El correo electrónico que muestra gcloud workspace-add-ons get-authorization

La página muestra también cuántos usuarios se han conectado. El guardado surte efecto desde la petición siguiente, sin reinicio. Pasar el estado a Disabled rechaza las peticiones que vienen de Google, dejando la página accesible para configurar la integración.

Referencia de configuración

Estas son las claves del elemento google_calendar de settings.conf, si prefiere editarlo directamente. En un clúster, el panel de administración no puede guardarlas: cada servidor lee su propio fichero de configuración, que hay que editar en cada uno de ellos.

Clave Por defecto Significado
enabled false Activa la integración
listing_url URL de la ficha desde la que los usuarios instalan el complemento
service_account_email Cuenta de servicio del despliegue, con la que Google llama al complemento
meeting_scheduling true Ofrece Google Calendar en el botón de calendario de la aplicación Drovio, mientras la integración está activada

Usar el complemento

Una vez instalado el complemento para el dominio, Google Calendar muestra Drovio en el panel lateral y en las opciones de videoconferencia de los eventos:

Dónde Lo que hace
Drovio meeting, en las opciones de videoconferencia de un evento Crea la reunión de Drovio del evento y coloca en él su enlace para unirse
La tarjeta Drovio, en el panel lateral Vincula la cuenta de Google del usuario con su cuenta de Drovio, muestra la cuenta de Drovio con la que está conectado el complemento, y permite al usuario desconectarlo

Los cambios de un evento llegan a su reunión de Drovio una vez guardado el evento.

Vincular la cuenta de Drovio

La primera vez, el complemento abre una ventana en su instancia de Drovio Server para vincular la cuenta de Google del usuario con su cuenta de Drovio:

  • a un usuario que ya ha iniciado sesión en Drovio en su navegador se le pide confirmar la cuenta que vincular, con Connect;
  • cualquier otro usuario inicia sesión primero y confirma después. La página de inicio de sesión es la de su servidor, o un formulario de la integración cuando su servidor no tiene ninguna.

La vinculación se mantiene hasta que el usuario la desconecta, desde la tarjeta Drovio del panel lateral. Debe completarse en el cuarto de hora siguiente a la apertura de la ventana.

Eventos nunca guardados

El complemento crea la reunión de Drovio en cuanto se elige Drovio meeting, mientras que Google no informa de nada sobre un evento cerrado sin guardar. Un día después, la próxima vez que el usuario abre la tarjeta Drovio o modifica su calendario, el complemento comprueba el evento con Google y elimina la reunión de un evento que nunca se guardó, o que se guardó sin ella.

Programar desde la aplicación Drovio

Mientras la integración está activada y meeting_scheduling está activo, el botón de calendario de la aplicación Drovio ofrece Google Calendar. Lo que abre al elegirlo depende del usuario:

  • un usuario que ha vinculado el complemento obtiene un nuevo evento de Google Calendar, donde elige Drovio meeting en las opciones de videoconferencia: el complemento crea la reunión y la mantiene al día con el evento;
  • para cualquier otro usuario se crea una reunión de Drovio, y después se abre un nuevo evento rellenado con su enlace para unirse, como ubicación y en su descripción. El asunto y la descripción se redactan en el idioma de la cuenta de Drovio del usuario. La reunión empieza cuando el usuario elige Google Calendar y dura una hora, ya que nada indica a su servidor cuándo tiene lugar el evento; su enlace permite unirse a ella en cualquier momento.

La aplicación muestra el botón de calendario a partir de la aplicación Drovio 3.7.1, con los medios de programación que ofrecen las integraciones de su servidor: ninguno lo oculta, uno lo abre directamente, varios abren un menú. Consulte Aplicación Drovio.