Qué está cambiando
Además de leer y escribir datos sobre la ubicación de trabajo, estamos ampliando la funcionalidad de la Calendar API para incluir datos sobre el tiempo fuera de la oficina y el tiempo de concentración. Los desarrolladores pueden utilizar la API para leer y escribir esta información y sincronizar la disponibilidad de los usuarios con sistemas externos. Por ejemplo, puede utilizar la API junto con los sistemas de RR.HH. para añadir automáticamente entradas de OOO al calendario de un usuario cuando envíe tiempo de vacaciones. O se puede utilizar la API para bloquear automáticamente el tiempo de atención en el calendario de un usuario para completar cursos de formación.
Leer y escribir fuera de la oficina y el tiempo de enfoque es útil en una variedad de situaciones, tales como: Creación y actualización de eventos de OOO y Focus Time (
Eventos.Insertar,
Eventos.Actualizar,
Eventos.parche). Especificación de funciones específicas de OOO y Focus Time, como la cancelación automática de reuniones y el establecimiento de estados de no molestar. Seleccionar cualquier combinación de tipos de eventos para leer de un calendario (
Eventos.Lista).
Además, la lectura y escritura de esta información elimina la necesidad de que los usuarios introduzcan la misma información en varios sistemas, lo que ayuda a reducir la rotación manual.
A quién afecta
Desarrolladores
Por qué utilizarlo
El apoyo a los actos fuera de la oficina y a las horas de concentración se une al apoyo al lugar de trabajo, que era
anunciada a principios de este añopara completar la funcionalidad de la API para eventos de calendario. Cada tipo de evento específico se puede sincronizar en todo el ecosistema informático de su organización, creando recorridos de usuario fluidos y ayudando a conectar a los usuarios con los recursos y entre sí. Esto incluye cosas como:
Mapear los datos de la ubicación de trabajo para adaptar mejor los recursos in situ y actualizar otras superficies de terceros, como las herramientas de reserva de hot desk. Bloqueo automático de OOO en función de las vacaciones o las solicitudes de PTO. Bloqueo de los eventos de tiempo de concentración para dar tiempo a los usuarios a pasar por la incorporación u otros programas de formación de la empresa.
Más información
Antes de esta actualización, si se solicitaba leer el calendario de un usuario a través de la API v3, se devolvían los eventos de fuera de oficina y de hora de atención con unknownorganizer@calendar.google.com en el campo organizador, y sin sus características específicas. Con esta actualización, estos eventos se devolverán con todas sus propiedades y el usuario específico como organizador. Por favor, comprueba tu código para asegurarte de que no hace suposiciones implícitas sobre los anteriores valores de retorno de la API, y utiliza la función
eventType parámetro para realizar diferentes operaciones con eventos regulares, OOO, Focus Time o Working Location
Para empezar
Ritmo de implantación
Ámbitos de liberación rápida y liberación programadaDespliegue ampliado (potencialmente superior a 15 días para la visibilidad de las funciones) a partir del 16 de noviembre de 2023.
Disponibilidad
La API Calendario está disponible para todos.
Los eventos fuera de la oficina están disponibles para los 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 Focus Time están disponibles para los clientes de Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard y Education Plus.
Recursos
