Setting up a Google Calendar Integration
Connect and display a Google Calendar in Confluence using Brikit Calendar Integrations.
Once you have configured your Google Calendar for sharing, it's time to add it to your Confluence pages. This guide describes how you can use the Brikit Calendar Integrations macro to add and connect your Google Calendar.
Prerequisite: ensure your Google Calendar is set up for sharing.
The steps below require three key points of information, derived from Configuring a Google Calendar for Use in Confluence. You will need:
- Email address associated with the Google Calendar
- Google service account email address (ID)
- Service account credentials file (a JSON download)
Determine if you have System Administrator privileges
In order to configure the Google Calendar, you must be a System Administrator.
Navigate to a page and edit it
Add the Google Calendar Events Browser Macro
Add the macro to the page, then click the macro and Edit it. In the first macro parameter, enter the email address associated with the Calendar. In the next parameter, Google User ID, enter the service account email address (this is the address that looks something like "brikit-google-calendars@crazy-chickens-123456.iam.gserviceaccount.com"). Configure any other parameters as you see fit. Click save in the Macro window, then Save the edits to the page.
After adding the Google Calendar Events Browser Macro but before adding the credentials, you may see a warning message on the page stating that there was a problem connecting to the calendar, or a 'null' value error. That's ok. Proceed to the next step to complete the connection.
Add credentials
Navigate to the General Configuration > Brikit Google Calendars > Credentials page, in the Confluence administration area.
- Under “Upload new credentials” click “Choose File” and then select the downloaded JSON credentials file, then confirm
With a successful upload, you should see a green check box icon next to your service account name.
View the calendar on the page
Your connected Calendar should now be displaying events on the page as a list (or, if there are no events, then it should display the No Events Message).
