Ce qui change
Outre la lecture et l'écriture des données relatives au lieu de travail, nous étendons les fonctionnalités de l'API Calendrier aux données relatives à l'absence du bureau et aux heures de travail. Les développeurs peuvent utiliser l'API pour lire et écrire ces informations et synchroniser la disponibilité des utilisateurs avec des systèmes externes. Par exemple, vous pouvez utiliser l'API en conjonction avec des systèmes de ressources humaines pour ajouter automatiquement des entrées OOO au calendrier d'un utilisateur lorsqu'il soumet des congés. L'API peut également être utilisée pour bloquer automatiquement des plages horaires dans le calendrier d'un utilisateur afin qu'il puisse suivre des cours de formation.
La lecture et l'écriture en dehors du bureau et du temps de concentration sont utiles dans diverses situations, telles que : la création et la mise à jour d'événements en dehors du bureau et du temps de concentration (
Événements.Insérer,
Événements.Mise à jour,
Patch.événements). Spécification de fonctions spécifiques à OOO et à Focus Time, telles que le refus automatique de réunions et la définition d'un statut "ne pas déranger". Sélection de n'importe quelle combinaison de types d'événements à lire à partir d'un calendrier (
Liste des événements).
En outre, la lecture et la rédaction de ces informations évitent aux utilisateurs d'avoir à saisir les mêmes informations dans plusieurs systèmes, ce qui contribue à réduire le nombre de changements manuels.
Qui est concerné ?
Développeurs
Pourquoi l'utiliser ?
Le soutien aux événements en dehors du bureau et au moment de la concentration rejoint le soutien au lieu de travail, qui était le plus important.
annoncée au début de l'annéeL'API de l'agenda a été complétée par l'API de l'agenda de l'entreprise. Chaque type d'événement spécifique peut être synchronisé dans l'ensemble de l'écosystème informatique de votre organisation, ce qui permet de créer des parcours utilisateurs transparents et de connecter les utilisateurs aux ressources et les uns aux autres. Cela inclut des éléments tels que :
Cartographier les données relatives au lieu de travail pour mieux adapter les ressources sur place et mettre à jour d'autres surfaces tierces, telles que les outils de réservation de hot desk. Bloquer automatiquement les périodes d'inactivité en fonction des demandes de congés ou de congés payés, bloquer les événements de temps de concentration pour donner aux utilisateurs le temps de suivre les programmes d'intégration ou d'autres programmes de formation de l'entreprise.
Détails supplémentaires
Avant cette mise à jour, si vous demandiez à lire le calendrier d'un utilisateur via l'API v3, les événements "out of office" et "focus time" étaient renvoyés avec unknownorganizer@calendar.google.com dans le champ organisateur, mais sans leurs caractéristiques spécifiques. Avec cette mise à jour, ces événements seront renvoyés avec toutes leurs propriétés et l'utilisateur spécifique en tant qu'organisateur. Veuillez vérifier votre code pour vous assurer qu'il ne fait pas de suppositions implicites sur les valeurs de retour de l'API précédente, et utilisez la fonction
type d'événement paramètre permettant d'effectuer différentes opérations avec les événements réguliers, OOO, Focus Time ou Working Location
Pour commencer
Rythme de déploiement
Domaines de la mise à disposition rapide et de la mise à disposition programméeDéploiement prolongé (potentiellement plus de 15 jours pour la visibilité des fonctionnalités) à partir du 16 novembre 2023
Disponibilité
L'API Calendrier est accessible à tous.
Les événements en dehors du bureau sont disponibles pour les clients Google Workspace Essentials, Enterprise Essentials, Frontline, Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Starter, Business Standard, Business Plus, Education Fundamentals, Education Standard et Education Plus.
Les événements Focus Time sont accessibles aux clients de Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard et Education Plus.
Ressources
