Este artículo es la traducción del blog inglés publicado el 17 de noviembre .
¿Qué cambios implementamos?
Además de leer y escribir datos de ubicación de trabajo, también ampliaremos la funcionalidad de la API de Calendar para incluir datos de fuera de la oficina y tiempo dedicado. Los desarrolladores pueden usar la API para leer y escribir esta información y sincronizar la disponibilidad de los usuarios con sistemas externos. Por ejemplo, puedes usar la API junto con los sistemas de RR.HH. para agregar automáticamente entradas de períodos fuera de la oficina (OOO) al calendario de un usuario cuando solicita un período de vacaciones. También puedes usar la API para establecer automáticamente el tiempo dedicado en el calendario de un usuario para completar cursos de capacitación.
Leer y escribir los eventos de tiempo dedicado y fuera de la oficina es útil en varias situaciones, como las siguientes:
Crear y actualizar eventos de OOO y tiempo dedicado (Events.Insert , Events.Update , Events.Patch ).
Especificar funciones específicas de OOO y tiempo dedicado, como rechazar reuniones automáticamente y establecer estados de No interrumpir.
Seleccionar cualquier combinación de tipos de eventos para leer desde un calendario (Events.List ).
Además, leer y escribir esta información elimina la necesidad de que los usuarios ingresen la misma información en múltiples sistemas, lo que ayuda a reducir el trabajo manual.
¿A quiénes afecta el cambio?
Desarrolladores
¿Por qué usarlo?
La compatibilidad con los eventos de fuera de la oficina y tiempo dedicado se integra a la compatibilidad con la ubicación de trabajo, que se
anunció a comienzos de este año , para completar la funcionalidad de la API para los eventos de calendario. Cada tipo de evento específico se puede sincronizar a través del ecosistema de TI de tu organización, lo que genera recorridos del usuario fluidos y ayuda a conectar a los usuarios con recursos y otros usuarios. Esto incluye lo siguiente:
Asignar datos de ubicación de trabajo para adaptar mejor los recursos del lugar y actualizar otras plataformas de terceros, como las herramientas de reserva de escritorios compartidos.
Establecer automáticamente tiempo OOO en función de vacaciones o solicitudes de licencias.
Bloquear eventos durante el tiempo dedicado para que los usuarios tengan tiempo para realizar integraciones y otros programas de capacitación de la empresa.
Detalles adicionales
Antes de esta actualización, si solicitabas leer el calendario de un usuario a través de la API v3, los eventos de fuera de la oficina y tiempo dedicado se mostraban con unknownorganizer@calendar.google.com en el campo del organizador y sin sus características específicas. Con esta actualización, estos eventos se mostrarán con todas sus propiedades y con el usuario específico como el organizador. Revisa tu código para garantizar que no tiene suposiciones implícitas sobre los valores anteriores que mostraba la API, además, usa el parámetro
eventType para realizar diferentes operaciones con eventos habituales, de OOO, tiempo dedicado o ubicación de trabajo.
Primeros pasos
Ritmo de lanzamiento
Disponibilidad
La API de Calendar está disponible para todos los usuarios. Los eventos fuera de la oficina están disponibles para clientes de Google Workspace Essentials, Enterprise Essentials, Frontline, Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Starter, Business Standard, Business Plus, Education Fundamentals, Education Standard y Education Plus.Los eventos de tiempo dedicado están disponibles para clientes de Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard y Education Plus.
Recursos
