FAQ content

Integrations: How to set up your Google Calendar for syncing with LibCal

In this article

Google Calendar integration allows you to automatically add your LibCal calendar events, space bookings, and appointments to one or more of your Google Calendars. This is a great way to easily keep tabs on upcoming events, bookings, and appointments.


Step 1. Set up a Google Service account

The first step to integrating LibCal with your Google Calendar is obtaining a Google Services account. Google makes this a little convoluted, but follow the steps below and you'll be done in no time. :)

  1. Sign into the Google Cloud Platform using your Google account.
  2. In the navigation bar, click on the Projects button.
    1. If you have an existing project you want to use, select it from the list and click OPEN.
    2. Otherwise, click on New Project to create a new one.
Selecting or creating a new project
  1. If creating a new project, give it a name (for example, "Libstaffer Sync") and click the Create button. It may take a few seconds for Google to create the project -- that's normal.
Creating a new project
  1. From the project's dashboard page, click on Library in the APIs & Services sidebar.
Clicking on the Library menu link
  1. The Library will present the available APIs you can use. Search for and click on the Google Calendar API.
The Google Calendar API search result
  1. On the Google Calendar API page, click on the Enable button at the top of the page.
Enabling the Google Calendar API
  1. Once enabled, you'll see an alert about needing credentials. Click on the Create Credentials button.
Screenshot highlighting the Create Credentials button
  1. On the Create credentials page, select Google Calendar API for step 1 Credential Type.
  2. Select Application data for the type of data you will be accessing.
  3. Select No, I'm not using them.
  4. Click Next.
Screenshot highlighting the Service Account link
  1. Under the Service Account Details step, give your service account a name (this could be the same name as your project). 
  2. Click the Done button.
    • You do not need to grant service account access or user access.
Example of creating a service account
  1. You'll be redirected to the Credentials page. From here, copy the email address for your new service account listed in the Email field.
    • You'll need this when preparing your Google Calendar and within LibCal's setup.
  2. Then click the Edit Service Account link for your newly created service account.
The edit service account button button
  1. Click on the Keys tab for the service account.
  2. From the Add Key dropdown, select Create new key.
The Create Key button
  1. Choose the appropriate Key Type.
    • Spaces integration: select JSON as the format.
    • Calendars integration: JSON or P12 format can be used.
    • Appointments & Room Bookings integration: select P12 as the format.
  2. Click Create. You'll receive a confirmation screen with your private key's password. (You can jot this down if you'd like, but you won't need it for the LibCal integration.)
    • The key file will also download (be sure to hold onto this -- you'll need it any time you want to sync with this service account). 
    • You can close the confirmation window.
The Key Type options

Step 2. Prepare your Google Calendar

Next, you need to set up your Google Calendar. You can use any of your calendars listed under "My Calendars" in your Google Calendar account (anything listed under "Other Calendars" aren't owned by you, so you can't sync to those).

  1. Click on the Options () button next to your calendar.

Navigating to the Settings and Sharing option

  1. From the dropdown menu, select Settings and Sharing.
  2. In your calendar's settings, under Share with Specific People, click on Add People.

Screenshot of the Add People link

  1. Enter the email address of your Google Service Account.
  2. From the Permissions dropdown, select Make Changes to Events.
  3. Click the Send button to save your changes.

Example of sharing with your Google Service Account

  1. In your calendar's settings, under Integrate Calendar, copy the Calendar ID (you'll need this when setting up LibCal, so it may be helpful to leave this tab open in your browser).

Example of a Calendar ID