Google Calendar: Integration Guide

This article explains how to enable synchronization between Google resources and YAROOMS spaces.

1. What is the Google Calendar integration

This integration enables synchronization between Google resources and YAROOMS spaces. You can map spaces in YAROOMS with resources in your Google tenant to enable automatic synchronization of events from and to YAROOMS.

2. Requirements

Enable APIs for your project

Any application that calls Google APIs needs to enable those APIs in the API Console.

To enable an API for your project:

  1. Open the API Library in the Google API Console.
  2. If prompted, select a project or create a new one.
  3. Select Google Calendar API, then click the Enable button.

Create a service account

Any application that uses OAuth 2.0 to access Google APIs must have authorization credentials that identify the application to Google’s OAuth 2.0 server.

The following steps explain how to create credentials for your project. Your applications can then use the credentials to access APIs that you have enabled for that project.

  1. Go to the Credentials page.
  2. Click Create credentials → Service Account.
  3. Fill in a name and description.
  4. Open the newly created service account, go to Keys → Add key → Create new key, and choose JSON.
  5. Store the downloaded JSON file securely. You will paste its contents into YAROOMS later.
  6. Configure domain-wide delegation as described below.

Then, a super administrator of the Google Workspace domain must complete the following steps:

  1. From your Google Workspace domain’s Admin console, go to Security → Access and data control → API controls.
  2. In the Domain wide delegation pane, select Manage Domain Wide Delegation.
  3. Click Add new.
  4. In the Client ID field, enter the service account’s Client ID. You can find your service account’s client ID in the Service accounts page.
  5. In the OAuth scopes (comma-delimited) field, enter https://www.googleapis.com/auth/calendar.readonly,https://www.googleapis.com/auth/calendar.events.
  6. Click Authorize.

Create room resources (optional)

If your rooms are not already available as Google Workspace resources, follow Google’s room resource setup guide. You can use existing resources instead of creating new ones.

Create a delegated account

Choose or create a Google Workspace user that the service account will impersonate to manage events in the mapped resource calendars. Make sure this user has permission to read and manage events in those calendars.

The delegated user is a Google Workspace user, not the service account email address. Check its access to the resource calendars before configuring the mappings.

3. Creating the Google Calendar integration

Go to Settings → Integrations → Google Calendar.

Options tab

Under Service account, complete the following:

  • Turn on Integration active.
  • In Scopes, enter the scopes you authorized in Google Workspace during setup, separated by commas.
  • In JSON key, paste the full contents of the file downloaded when creating the service account key, not the filename.

Google Calendar Options tab with Integration active, Scopes, and JSON key fields

Warning: The JSON file contains a private key. Keep it secure and do not include its contents in screenshots or shared documents.

Resource mapping tab

Open Resource mapping and configure the Sync section:

  • Turn on Activate Google Calendar sync.
  • Mute notifications: Choose whether to suppress notifications from YAROOMS or Google for events created by synchronization. Leave NONE selected if you do not want to mute them.
  • Conflict resolution: Choose which system takes priority when conflicting bookings are created in Google Calendar and YAROOMS.
  • Delegated user: Enter the email address of the Google Workspace user that will manage events in the mapped calendars.

Google Calendar Resource mapping tab showing synchronization settings and a resource mapped to a YAROOMS space

Warning: Conflict resolution can replace bookings. With YAROOMS priority, the conflicting Google booking is deleted and replaced with the YAROOMS booking. With Google priority, the conflicting YAROOMS booking is deleted and replaced with the Google booking. Choose the policy carefully before enabling synchronization.

Map resources to spaces

  1. In Resources, click Add mapping to add a row.
  2. In External resource, enter the Google room resource’s email address.
  3. In YAROOMS space, select the corresponding space.
  4. Repeat for the other resources you want to synchronize, then click Save.

You can find the resource email in Google Admin console → Buildings and resources, by opening the resource and locating Resource email.

Resource email location in Google Admin console

To remove a mapping, use the trash icon on its row and save your changes.

Can't find what you're looking for?

Our support team is here to help. Reach out and we'll get back to you quickly.

Contact Support

We use cookies to analyze traffic and improve your experience.

Cookie preferences

Essential

Required for the site to function

Always on
Analytics

Help us understand how visitors use the site

Marketing

Used to deliver relevant ads

Talk to Sales or Support