{"id":987515613,"date":"2023-11-17T19:13:18","date_gmt":"2023-11-17T19:13:18","guid":{"rendered":"https:\/\/workspace.trace.pt\/read-and-write-out-of-office-and-focus-time-events-using-the-calendar-api\/"},"modified":"2023-11-17T19:13:18","modified_gmt":"2023-11-17T19:13:18","slug":"read-and-write-out-of-office-and-focus-time-events-using-the-calendar-api","status":"publish","type":"post","link":"https:\/\/workspace.trace.pt\/fr\/read-and-write-out-of-office-and-focus-time-events-using-the-calendar-api\/","title":{"rendered":"Lire et \u00e9crire des \u00e9v\u00e9nements en dehors du bureau et de l'heure de travail \u00e0 l'aide de l'API Calendrier"},"content":{"rendered":"<h3>Ce qui change\u00a0<\/h3>\n<div>Outre la lecture et l'\u00e9criture des donn\u00e9es relatives au lieu de travail, nous \u00e9tendons les fonctionnalit\u00e9s de l'API Calendrier aux donn\u00e9es relatives \u00e0 l'absence du bureau et aux heures de travail. Les d\u00e9veloppeurs peuvent utiliser l'API pour lire et \u00e9crire ces informations et synchroniser la disponibilit\u00e9 des utilisateurs avec des syst\u00e8mes externes. Par exemple, vous pouvez utiliser l'API en conjonction avec des syst\u00e8mes de ressources humaines pour ajouter automatiquement des entr\u00e9es OOO au calendrier d'un utilisateur lorsqu'il soumet des cong\u00e9s. L'API peut \u00e9galement \u00eatre utilis\u00e9e pour bloquer automatiquement des plages horaires dans le calendrier d'un utilisateur afin qu'il puisse suivre des cours de formation.\u00a0<\/div>\n<div><\/div>\n<div>La lecture et l'\u00e9criture en dehors du bureau et du temps de concentration sont utiles dans diverses situations, telles que : la cr\u00e9ation et la mise \u00e0 jour d'\u00e9v\u00e9nements en dehors du bureau et du temps de concentration (<a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/insert\">\u00c9v\u00e9nements.Ins\u00e9rer<\/a>, <a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/update\">\u00c9v\u00e9nements.Mise \u00e0 jour<\/a>, <a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/patch\">Patch.\u00e9v\u00e9nements<\/a>). Sp\u00e9cification de fonctions sp\u00e9cifiques \u00e0 OOO et \u00e0 Focus Time, telles que le refus automatique de r\u00e9unions et la d\u00e9finition d'un statut \"ne pas d\u00e9ranger\". S\u00e9lection de n'importe quelle combinaison de types d'\u00e9v\u00e9nements \u00e0 lire \u00e0 partir d'un calendrier (<a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/list\">Liste des \u00e9v\u00e9nements<\/a>).\u00a0<\/div>\n<div><\/div>\n<div>En outre, la lecture et la r\u00e9daction de ces informations \u00e9vitent aux utilisateurs d'avoir \u00e0 saisir les m\u00eames informations dans plusieurs syst\u00e8mes, ce qui contribue \u00e0 r\u00e9duire le nombre de changements manuels.<\/p>\n<\/div>\n<div><\/div>\n<div><\/div>\n<div>\n<h3>Qui est concern\u00e9 ?<\/h3>\n<div>D\u00e9veloppeurs<\/div>\n<div><\/div>\n<div><\/div>\n<h3>Pourquoi l'utiliser ?<\/h3>\n<div>Le soutien aux \u00e9v\u00e9nements en dehors du bureau et au moment de la concentration rejoint le soutien au lieu de travail, qui \u00e9tait le plus important. <a href=\"https:\/\/workspaceupdates.googleblog.com\/2023\/08\/calendar-api-working-location-read-write-generally-available.html\">annonc\u00e9e au d\u00e9but de l'ann\u00e9e<\/a>L'API de l'agenda a \u00e9t\u00e9 compl\u00e9t\u00e9e par l'API de l'agenda de l'entreprise. Chaque type d'\u00e9v\u00e9nement sp\u00e9cifique peut \u00eatre synchronis\u00e9 dans l'ensemble de l'\u00e9cosyst\u00e8me informatique de votre organisation, ce qui permet de cr\u00e9er des parcours utilisateurs transparents et de connecter les utilisateurs aux ressources et les uns aux autres. Cela inclut des \u00e9l\u00e9ments tels que :<\/div>\n<div><\/div>\n<div><\/div>\n<div>Cartographier les donn\u00e9es relatives au lieu de travail pour mieux adapter les ressources sur place et mettre \u00e0 jour d'autres surfaces tierces, telles que les outils de r\u00e9servation de hot desk. Bloquer automatiquement les p\u00e9riodes d'inactivit\u00e9 en fonction des demandes de cong\u00e9s ou de cong\u00e9s pay\u00e9s, bloquer les \u00e9v\u00e9nements de temps de concentration pour donner aux utilisateurs le temps de suivre les programmes d'int\u00e9gration ou d'autres programmes de formation de l'entreprise.<\/div>\n<div><\/div>\n<h3><\/h3>\n<h3>D\u00e9tails suppl\u00e9mentaires<\/h3>\n<div>Avant cette mise \u00e0 jour, si vous demandiez \u00e0 lire le calendrier d'un utilisateur via l'API v3, les \u00e9v\u00e9nements \"out of office\" et \"focus time\" \u00e9taient renvoy\u00e9s avec unknownorganizer@calendar.google.com dans le champ organisateur, mais sans leurs caract\u00e9ristiques sp\u00e9cifiques. Avec cette mise \u00e0 jour, ces \u00e9v\u00e9nements seront renvoy\u00e9s avec toutes leurs propri\u00e9t\u00e9s et l'utilisateur sp\u00e9cifique en tant qu'organisateur. Veuillez v\u00e9rifier votre code pour vous assurer qu'il ne fait pas de suppositions implicites sur les valeurs de retour de l'API pr\u00e9c\u00e9dente, et utilisez la fonction <a href=\"https:\/\/developers.google.com\/calendar\/api\/v3\/reference\/events#:~:text=of%20the%20resource.-,eventType,-string\">type d'\u00e9v\u00e9nement<\/a> param\u00e8tre permettant d'effectuer diff\u00e9rentes op\u00e9rations avec les \u00e9v\u00e9nements r\u00e9guliers, OOO, Focus Time ou Working Location\u00a0<\/div>\n<\/div>\n<div><\/div>\n<div><\/div>\n<div>\n<h3>Pour commencer<\/h3>\n<div>Administrateurs : Il n'y a pas de contr\u00f4le administratif pour cette fonctionnalit\u00e9.<\/p>\n<p>D\u00e9veloppeurs : utilisez notre documentation pour d\u00e9veloppeurs pour plus d'informations sur <a href=\"https:\/\/developers.google.com\/calendar\/api\/guides\/calendar-status\">la gestion du temps de concentration, de l'absence du bureau et des \u00e9v\u00e9nements sur le lieu de travail<\/a>.<\/p>\n<p>Utilisateurs finaux : Aucune action n'est requise de la part des utilisateurs finaux. Visitez le centre d'aide pour en savoir plus sur <a href=\"https:\/\/support.google.com\/calendar\/answer\/7638168\">montrer lorsque vous n'\u00eates pas en fonction<\/a> ou <a href=\"https:\/\/support.google.com\/calendar\/answer\/11190973\">utiliser le temps de concentration<\/a> dans le calendrier.\u00a0<\/div>\n<div><\/div>\n<h3>Rythme de d\u00e9ploiement<\/h3>\n<div><a href=\"https:\/\/support.google.com\/a\/answer\/172177\">Domaines de la mise \u00e0 disposition rapide et de la mise \u00e0 disposition programm\u00e9e<\/a>D\u00e9ploiement prolong\u00e9 (potentiellement plus de 15 jours pour la visibilit\u00e9 des fonctionnalit\u00e9s) \u00e0 partir du 16 novembre 2023<\/p>\n<div>\n<h3>Disponibilit\u00e9<\/h3>\n<div>L'API Calendrier est accessible \u00e0 tous.\u00a0<\/p>\n<p>Les \u00e9v\u00e9nements 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.<\/p>\n<p>Les \u00e9v\u00e9nements 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.<\/p><\/div>\n<h3>Ressources<\/h3>\n<div><a href=\"https:\/\/developers.google.com\/calendar\/api\/guides\/calendar-status\">Documentation \u00e0 l'intention des d\u00e9veloppeurs : gestion des temps de concentration, des absences du bureau et des \u00e9v\u00e9nements li\u00e9s au lieu de travail<\/a><a href=\"https:\/\/support.google.com\/calendar\/answer\/11190973\">Google Help : Utiliser le temps de concentration dans Google Agenda<\/a><a href=\"https:\/\/support.google.com\/calendar\/answer\/7638168\">Google Help : Montrer que vous n'\u00eates pas au travail<\/a><\/div>\n<div><\/div>\n<\/div>\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>What\u2019s changing\u00a0 In addition to reading and writing working location data, we\u2019re expanding the Calendar API functionality to encompass out of office and focus time data. Developers can use the API to read and write this information and synchronize users\u2019 availability with external systems. For example, you can use the API in conjunction with HR [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[1],"tags":[],"class_list":["post-987515613","post","type-post","status-publish","format-standard","hentry","category-noticias"],"acf":[],"_links":{"self":[{"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/posts\/987515613","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/comments?post=987515613"}],"version-history":[{"count":0,"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/posts\/987515613\/revisions"}],"wp:attachment":[{"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/media?parent=987515613"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/categories?post=987515613"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/workspace.trace.pt\/fr\/wp-json\/wp\/v2\/tags?post=987515613"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}