Google Workspace Calendar Integration
Out of Office Assistant reads the Out of office events in your Google Calendar and creates Out of Office rules in Jira from them. The connection is personal: you connect your own Google account, and the app reads only that calendar.
Before you connect
A Google Workspace account is required. A personal Gmail account cannot be connected.
Google asks for read-only access to your calendar and for your name and email address, so the app reads events but cannot change your calendar.
Your Google Workspace administrator may have to approve the app before you can grant that access.
The authorization link belongs to the Jira user who started the connection, so passing it to a colleague to finish does not work.
Connect your calendar
Open Apps > Out of Office Assistant in the Jira navigation, then go to My Integrations.
On the Google Calendar card, follow the authorization link and sign in with your Google Workspace account.
Review the access Google asks for and allow it.
Back on the card, a green check beside Google Calendar and a count of the rule templates configured confirm the connection. Show connection details, Disconnect and How it works sit below them.
Choose which events create rules
Select Configure, the gear on the card, to open Google Workspace (Personal) Integration. Only events whose Google Calendar type is Out of office are read, so ordinary meetings are ignored. Create rules for controls which of those events create rules, and is set to All events by default.
What an event creates
An Out of office event creates one rule for every template connected on this page, so two templates make two rules out of one event. Each rule takes its scope, coverers, approver coverers and message from its own template, and its dates from the event.
What you write in the Google Calendar event is not carried into the rule. The message your colleagues see comes from the template, so edit the template to change the wording.
The rules appear on My Rules with the Google Calendar logo in the Creator column. An all-day event shows its date, or its first and last date, followed by All day, with no times and no timezone. An event with a start and an end time keeps those times and shows the timezone they are read in. Rules whose event is over are listed under Past integration rules on the same tab.
Change or stop the rules
The rules follow the calendar. Move the dates on an event, or delete the event, and the rules follow at the next integration sync, which runs every 15 minutes. To change what a rule does rather than when it applies, edit the template it came from. To stop the integration altogether, select Disconnect on the card.
An administrator can connect a Global template to the integration. It creates rules from your events in the same way your own templates do, and goes on doing so until you remove it from Your templates on your Configure page. What a global template contains is the administrator's to change; you cannot edit it yourself. Templates for Out of Office Rules covers connecting, removing and editing templates.