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:
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:
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.
# 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
}
Conviértalo después en el proyecto actual de la Google Cloud CLI, sobre el que actúan los comandos de los pasos siguientes:
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.