Google Workspace Integration

A user with administrative privileges for the Google Workspace domain is required to configure the integration, create a dedicated service acccount and retrive its credentials. After this, each user has to share their calendar with the configured service account.

Configuration of the Google Workspace service account

Below is a step-by-step guide to setup the service account and credentials required for the integration. 

Login with an admin user

• Login to https://console.cloud.google.com as user with Google Workspace user admin privilieges for the domain to be integrated with

Create a new project

• Create a new project and name it, for example dstny-calendar-sync
• Select the new project

Enable the Calendar API

• Go to APIs & Services -> Library
• Search for the Google Calendar API
• Enable the Calendar API

Create a service account

• Go to APIs & Services -> Credentials
• Click Create Credentials and select Service account
• Give it a name (f.e. Dstny Calendar Sync 01) and an id (f.e. dstny-calendar-sync-01)
• Note the email address of the service account, this is what the users should share the calendar with
• Click Create and continue
• Search for the role Service Account Token Creator and add it to the service account
• Click Done

Create a new client

• Go to IAM & Admin -> Service Accounts
• Click the new service account
• Copy the Unique ID field
• Navigate to admin.google.com
• Got to Security -> API controls
• Click Manage domain wide delegation
• Click Add new
• Paste the Unique ID into the Client ID field
• Add the OAuth scopes https://www.googleapis.com/auth/calendar.events.readonly and https://www.googleapis.com/auth/calendar.readonly
• Click Authorize

Create service account credentials file

• Navigate back to https://console.cloud.google.com
• Navigate to IAM & Admin -> Service Account
• Click the new service account
• Go to Keys
• Click Add key
• Select JSON
• Click Create
• The service account key file should download to your local computer – keep it safe!

Once the service account key file has been downloaded it can be supplied to the Google Workspace calendar connector

Share the users’ calendar with the service account

The following procedure needs to be completed for each user that should use the integration.

Set up sharing of a user’s calendar

• The user should login and go to the calendar (https://calendar.google.com/calendar/u/0/r)
• Click the “gear” button in the top bar
• Select Settings
• Under Settings for my calendars, go to the calendar to share (the primary)
• Go to Share with specific people or groups and select Add people or group
• Add the email address of the service account
• Select See only free/busy (hide details)
• Click Send

Connect Google with Dstny DK phonesystem

• Go to www.connect.ipvision as a administrator
• Login 
• Choose Admin view

• Go to Organisation > Calendar Connectors
• Add Connector
• Choose "Google Workspace" as Connector type

• Upload the "Service account file" that you just created from your local machine.
• Done

Setup your synchronization

In the Dstny DK admin view

Go to Services > Presence and Contact synchronization 

• Select the organization or usergroup you wish to configure.
• Select the Connector in the dropdown
• Add rule