{"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":"Read and write out of office and focus time events using the Calendar API"},"content":{"rendered":"

What\u2019s changing\u00a0<\/h3>\n
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 systems to automatically add OOO entries to a user\u2019s calendar when they submit vacation time. Or the API can be used to automatically block focus time on a user\u2019s calendar to complete training courses.\u00a0<\/div>\n
<\/div>\n
Reading and writing out of office and focus time is helpful in a variety of situations such as:\u00a0Creating and updating OOO and Focus Time events (Events.Insert<\/a>, Events.Update<\/a>, Events.Patch<\/a>).\u00a0Specifying OOO and Focus Time specific features, such as auto-declining meetings, and setting do-not-disturb statuses.\u00a0Selecting any combination of event types to read from a calendar (Events.List<\/a>).\u00a0<\/div>\n
<\/div>\n
Further, reading and writing this information eliminates the need for users to enter the same information into multiple systems, helping to cut down on manual churn.<\/p>\n<\/div>\n
<\/div>\n
<\/div>\n
\n

Who\u2019s impacted<\/h3>\n
Developers<\/div>\n
<\/div>\n
<\/div>\n

Why you\u2019d use it<\/h3>\n
Out of office and focus time event support joins support for working location, which was announced earlier this year<\/a>, to round out API functionality for calendar events. Each specific event type can be synced throughout your organization’s IT ecosystem, creating seamless user journeys and helping to connect users with resources and each other. This includes things such as:<\/div>\n
<\/div>\n
<\/div>\n
Mapping working location data to better adapt on-site resources and update other third-party surfaces, such as hot desk booking tools.\u00a0Automatically blocking OOO based on vacation or PTO requests.Blocking off focus time events to give users time to go through onboarding or other company training programs.<\/div>\n
<\/div>\n

<\/h3>\n

Additional details<\/h3>\n
Prior to this update, if you requested to read a user\u2019s calendar via API v3, out of office and focus time events were returned with unknownorganizer@calendar.google.com in the organizer field, and without their specific features. With this update, these events will return with all their properties and the specific user as organizer. Please check your code to ensure it does not make implicit assumptions about the previous API return values, and use the eventType<\/a> parameter to perform different operations with regular, OOO, Focus Time, or Working Location events\u00a0<\/div>\n<\/div>\n
<\/div>\n
<\/div>\n
\n

Getting started<\/h3>\n
Admins: There is no admin control for this feature.<\/p>\n

Developers: Use our Developer Documentation for more information about managing focus time, out of office, and working location events<\/a>.<\/p>\n

End users: There is no end user action required. Visit the Help Center to learn more about showing when you’re out of office<\/a> or using focus time<\/a> in Calendar.\u00a0<\/div>\n

<\/div>\n

Rollout pace<\/h3>\n
Rapid Release and Scheduled Release domains<\/a>: Extended rollout (potentially longer than 15 days for feature visibility) starting on November 16, 2023<\/p>\n
\n

Availability<\/h3>\n
The Calendar API is available to all.\u00a0<\/p>\n

Out of Office events are available to Google Workspace Essentials, Enterprise Essentials, Frontline, Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Starter, Business Standard, Business Plus, Education Fundamentals, Education Standard, and Education Plus customers.<\/p>\n

Focus Time events are available to Google Workspace Enterprise Starter, Enterprise Standard, Enterprise Plus, Nonprofits, Business Standard, Business Plus, Education Fundamentals, Education Standard, and Education Plus customers.<\/p><\/div>\n

Resources<\/h3>\n
Developer Documentation: Manage focus time, out of office, and working location events<\/a>Google Help: Use focus time in Google Calendar<\/a>Google Help: Show when you\u2019re out of office<\/a><\/div>\n
<\/div>\n<\/div>\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"

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 […]<\/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}]}}