Google Workplace Integration - Calendar + Directory

This document aims to detail the whole process and the main implications of integrating a Skedway account with Google Workplace

Gateway

Skedway platform uses the Google Directory API and Calendar API to access users (read-only) accounts/groups and manipulate (read-write) resource and user calendars.

Scopes

• https://www.googleapis.com/auth/calendar

• https://www.googleapis.com/auth/admin.directory.user.readonly

• https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

• https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

• https://www.googleapis.com/auth/admin.directory.group.readonly

Steps

Activating the Skedway Integration

• Access Skedway with an account that has the access profile enabled for reading and writing from the Integrations submenu.

• If you do not have the appropriate credentials, contact the manager of your company responsible for Skedway.

1. Access the integration submenu by following these steps: Menu-ADMINISTRATION > Section-CONECTIONS > submenu-INTEGRATIONS

2. Create a new integration by clicking on the NEW button and select the desired gateway. The following information and fields will be updated according to the chosen gateway. Select "Google Calendar & Google Directory"

3. Fill in the fields according to the requirements

   1. Account to impersonate (email)

   2. Primary domain

4. Configuration done!! The settings in Skedway are finished, now it is necessary to configure Google Workspace

   1. Scopes

   2. Client ID

Enabling Integration in Google Workspace

In Google Workspace it is necessary that the user has the domain configuration permission

The organization and layout of the menus may vary due to constant changes and improvements made by Google

1. Within the Google Console, go to MAIN MENU > SECURITY > APIS CONTROL > ENTIRE DOMAIN DELEGATION

2. In this panel select the option to MANAGE ENTIRE DOMAIN DELEGATION.

3. Create a new API control in ADD NEW

4. On the screen, set the Skedway identifier code with the Client ID generated in the Skedway.

5. Copy the access links (Scopos) in each Auth Scopes field.

6. Authorize the scopes.

7. Done!

• Scopes and permissions are mandatory for integration completion

• The registered manager will have full control of the permissions given to the Skedway application.

• These permissions can be revoked at any time if necessary.

References

Google Calendar for Developers  |  Google DevelopersGoogle Developers

Directory API Overview  |  Admin console  |  Google DevelopersGoogle Developers

Using OAuth 2.0 for Server to Server Applications  |  Authorization  |  Google DevelopersGoogle Developers

Control API access with domain-wide delegation - Google Workspace Admin Help