{"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\/es\/read-and-write-out-of-office-and-focus-time-events-using-the-calendar-api\/","title":{"rendered":"Leer y escribir eventos fuera de la oficina y de la hora de atenci\u00f3n utilizando la API de Calendario"},"content":{"rendered":"<h3>Qu\u00e9 est\u00e1 cambiando\u00a0<\/h3>\n<div>Adem\u00e1s de leer y escribir datos sobre la ubicaci\u00f3n 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\u00f3n. Los desarrolladores pueden utilizar la API para leer y escribir esta informaci\u00f3n 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\u00f1adir autom\u00e1ticamente entradas de OOO al calendario de un usuario cuando env\u00ede tiempo de vacaciones. O se puede utilizar la API para bloquear autom\u00e1ticamente el tiempo de atenci\u00f3n en el calendario de un usuario para completar cursos de formaci\u00f3n.\u00a0<\/div>\n<div><\/div>\n<div>Leer y escribir fuera de la oficina y el tiempo de enfoque es \u00fatil en una variedad de situaciones, tales como: Creaci\u00f3n y actualizaci\u00f3n de eventos de OOO y Focus Time (<a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/insert\">Eventos.Insertar<\/a>, <a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/update\">Eventos.Actualizar<\/a>, <a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/patch\">Eventos.parche<\/a>). Especificaci\u00f3n de funciones espec\u00edficas de OOO y Focus Time, como la cancelaci\u00f3n autom\u00e1tica de reuniones y el establecimiento de estados de no molestar. Seleccionar cualquier combinaci\u00f3n de tipos de eventos para leer de un calendario (<a href=\"https:\/\/developers.google.com\/calendar\/v3\/reference\/events\/list\">Eventos.Lista<\/a>).\u00a0<\/div>\n<div><\/div>\n<div>Adem\u00e1s, la lectura y escritura de esta informaci\u00f3n elimina la necesidad de que los usuarios introduzcan la misma informaci\u00f3n en varios sistemas, lo que ayuda a reducir la rotaci\u00f3n manual.<\/p>\n<\/div>\n<div><\/div>\n<div><\/div>\n<div>\n<h3>A qui\u00e9n afecta<\/h3>\n<div>Desarrolladores<\/div>\n<div><\/div>\n<div><\/div>\n<h3>Por qu\u00e9 utilizarlo<\/h3>\n<div>El apoyo a los actos fuera de la oficina y a las horas de concentraci\u00f3n se une al apoyo al lugar de trabajo, que era <a href=\"https:\/\/workspaceupdates.googleblog.com\/2023\/08\/calendar-api-working-location-read-write-generally-available.html\">anunciada a principios de este a\u00f1o<\/a>para completar la funcionalidad de la API para eventos de calendario. Cada tipo de evento espec\u00edfico se puede sincronizar en todo el ecosistema inform\u00e1tico de su organizaci\u00f3n, creando recorridos de usuario fluidos y ayudando a conectar a los usuarios con los recursos y entre s\u00ed. Esto incluye cosas como:<\/div>\n<div><\/div>\n<div><\/div>\n<div>Mapear los datos de la ubicaci\u00f3n 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\u00e1tico de OOO en funci\u00f3n de las vacaciones o las solicitudes de PTO. Bloqueo de los eventos de tiempo de concentraci\u00f3n para dar tiempo a los usuarios a pasar por la incorporaci\u00f3n u otros programas de formaci\u00f3n de la empresa.<\/div>\n<div><\/div>\n<h3><\/h3>\n<h3>M\u00e1s informaci\u00f3n<\/h3>\n<div>Antes de esta actualizaci\u00f3n, si se solicitaba leer el calendario de un usuario a trav\u00e9s de la API v3, se devolv\u00edan los eventos de fuera de oficina y de hora de atenci\u00f3n con unknownorganizer@calendar.google.com en el campo organizador, y sin sus caracter\u00edsticas espec\u00edficas. Con esta actualizaci\u00f3n, estos eventos se devolver\u00e1n con todas sus propiedades y el usuario espec\u00edfico como organizador. Por favor, comprueba tu c\u00f3digo para asegurarte de que no hace suposiciones impl\u00edcitas sobre los anteriores valores de retorno de la API, y utiliza la funci\u00f3n <a href=\"https:\/\/developers.google.com\/calendar\/api\/v3\/reference\/events#:~:text=of%20the%20resource.-,eventType,-string\">eventType<\/a> par\u00e1metro para realizar diferentes operaciones con eventos regulares, OOO, Focus Time o Working Location\u00a0<\/div>\n<\/div>\n<div><\/div>\n<div><\/div>\n<div>\n<h3>Para empezar<\/h3>\n<div>Administradores: No hay control de administrador para esta funci\u00f3n.<\/p>\n<p>Desarrolladores: Utilicen nuestra Documentaci\u00f3n para desarrolladores para obtener m\u00e1s informaci\u00f3n sobre <a href=\"https:\/\/developers.google.com\/calendar\/api\/guides\/calendar-status\">gesti\u00f3n del tiempo de atenci\u00f3n, de los eventos fuera de la oficina y del lugar de trabajo<\/a>.<\/p>\n<p>Usuarios finales: No es necesaria ninguna acci\u00f3n por parte del usuario final. Visite el Centro de ayuda para obtener m\u00e1s informaci\u00f3n sobre <a href=\"https:\/\/support.google.com\/calendar\/answer\/7638168\">mostrando cuando est\u00e1s fuera de la oficina<\/a> o <a href=\"https:\/\/support.google.com\/calendar\/answer\/11190973\">utilizar el tiempo de enfoque<\/a> en Calendario.\u00a0<\/div>\n<div><\/div>\n<h3>Ritmo de implantaci\u00f3n<\/h3>\n<div><a href=\"https:\/\/support.google.com\/a\/answer\/172177\">\u00c1mbitos de liberaci\u00f3n r\u00e1pida y liberaci\u00f3n programada<\/a>Despliegue ampliado (potencialmente superior a 15 d\u00edas para la visibilidad de las funciones) a partir del 16 de noviembre de 2023.<\/p>\n<div>\n<h3>Disponibilidad<\/h3>\n<div>La API Calendario est\u00e1 disponible para todos.\u00a0<\/p>\n<p>Los eventos fuera de la oficina est\u00e1n 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.<\/p>\n<p>Los eventos de Focus Time est\u00e1n 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.<\/p><\/div>\n<h3>Recursos<\/h3>\n<div><a href=\"https:\/\/developers.google.com\/calendar\/api\/guides\/calendar-status\">Documentaci\u00f3n para desarrolladores: Gestionar el tiempo de atenci\u00f3n, los eventos fuera de la oficina y el lugar de trabajo<\/a><a href=\"https:\/\/support.google.com\/calendar\/answer\/11190973\">Ayuda de Google: Uso del tiempo de enfoque en Google Calendar<\/a><a href=\"https:\/\/support.google.com\/calendar\/answer\/7638168\">Google Help: Mostrar cuando est\u00e1s fuera de la oficina<\/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\/es\/wp-json\/wp\/v2\/posts\/987515613","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/comments?post=987515613"}],"version-history":[{"count":0,"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/posts\/987515613\/revisions"}],"wp:attachment":[{"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/media?parent=987515613"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/categories?post=987515613"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/workspace.trace.pt\/es\/wp-json\/wp\/v2\/tags?post=987515613"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}