Skip to main content

 

Eptura Knowledge Center

Google G-Suite configuration

Introduction

Condeco can integrate with Google G Suite allowing you to book meeting rooms directly from your Google Calendars. In order to do so, you need to allow API access to your resources and create calendars for your rooms.

This guide will discuss how to set up a G Suite calendar, building and rooms to connect to Condeco.

The G Suite navigation, field names and instructions in this guide were correct at the time of writing.

Allow API access to your resources

Enable the Calendar API

  1. Go to console.developers.google.com and log in with your super admin credentials.
  2. From the APIs & Services dashboard, click + Enable APIs and Services
    google-api-enable-api-and-services_v1.png
  1. Search for ‘calendar’ and select Google Calendar API.
  2. Click Enable.

Add credentials for the API

Now create credentials so the Condeco Screens can access this API.

  1. Click the Navigation menu (top left) and select IAM & Admin then Service accounts.
    google-iam-and-admin-service-account.png
  1. Click + Create Service Account
    google-api-create-service-account_v1.png
  1. Enter a Service account name, for example, ‘condeco-connect’ and click Create.
  2. In the Role drop-down menu, select Resource Manager > Organization Administrator and click Continue.
    google-api-role.png
  1. Click Done and the Service accounts table will display.
  2. Click Actions on your Service account and select Create key.
    google-create-key.png
  1. Select key type JSON then click Create.
    google-key-type-json_v1.png

Your Service account has now been created and its associated JSON key has been saved to your local computer. You need the JSON key when you create a Calendar Service in Condeco Screens.

Note that the raw key is not stored on Condeco Screens servers. The key file is encrypted when uploaded to the Condeco Screens servers and you apply a password of your choice. The screen will only be able to decrypt the key file when you tell it the password.

Make a note of the Unique ID

The Unique ID will be used when managing the API client access in the next step so make a note of it. You will find it on the Service account details page.
google-unique-id.png

Set the G Suite API permissions

First, you need to enable the calendar.

  1. Go to console.developers.google.com/ and log in with your super admin credentials.
  2. From the APIs & Services dashboard, scroll to the bottom and click Google Calendar API to open.
  3. Ensure the Activation Status is Enabled.
    google-api-enabled.png

Now you need to manage the API client access.

  1. Go to admin.google.com/ and log in with your super admin credentials.
  2. Click Security.
  3. Scroll to the bottom and click API controls.
  4. Scroll to the bottom and click MANAGE DOMAIN-WIDE DELEGATION.
  5. Click Add new and the Add a new client ID window will display.
    google-add-new-id.png
  1. In the Client ID field, enter the Unique ID copied from the Service Account earlier.
  2. Enter the following in OAuth scopes (comma-delimited):
https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.readonly
  1. Click Authorize.

Create a Calendar resource for Condeco

‘Rooms’ are ‘calendars’ and rooms in G Suite are set up as ‘Resources’. Before you can create a room resource and link it to your Condeco room, you need to create a ‘building’ for the room.

Creating a G Suite calendar, a building, and a room (resource).

Create a calendar
  1. Go to admin.google.com/ and log in with your super admin credentials.
  2. From the Admin Console click Apps.
  3. Click Google Workspace and click Calendar to open Settings for Calendar.
  4. Click Resources.
Add a building
  1. Click Add building then click the yellow circle with a + sign.
    google-api-add-buildings_v2.png
  2. Enter an ID and Name for the building.
  3. Enter the floor where the room is located.
  4. Click Add Building.
Add rooms (resource) to the building
  1. Click the drop-down menu on the navigation bar and select Resources.
  2. Select the building from the left tree.
  3. Click the yellow circle with a + sign to add a new resource.
    google-api-add-resource_v1.png
  4. For the Category select Meeting space.
  5. Select the Building and Floor.
  6. Enter the Resource name, for example ‘Meeting Room A’.
  7. Enter the Capacity of the room and complete the remaining fields as required.
  8. Click Add Resource.
  9. Click the new room to view the resource details and make a note of the Resource email as you will need it when you link the room to Condeco Screens.
    google-resource-email_v2.png

Congratulations! Your G Suite calendar is ready to be connected to Condeco meeting room screens. Learn how