Booking System Preparation - Google Workspace

This article will cover the process of preparing Google Workspace for HCP integration and during the process you will configure the following:

1. Create New Project
   • Configure Project Authorization
   • Global Calendar Sharing 
     
2. Create & Configure Resource Calendars

Create New Project

1. The first step in the process is to create a new project for the integration between HCP and Google Workspace. To do so navigate to Google Cloud Platform and log in using your Google Domain Admin
   
   
2. Click Create Project
   
   
3. Enter a name for your project and click Create
   
   
4. A notification should appear in the notification area when the project is created
   
   
5. Click on the notification to reach the API Manager or go to Menu Icon > API & Services > Dashboard
   
   
6. Click on Enable APIs and Services
   
   
7. The API Library will appear, search for “Google Calendar API”, Select Google Calendar API and click Enable
   
   
8. Repeat the previous step adding and enabling “Gmail API”
   
   
9. Enable the last needed API  “Admin SDK API” for the project
   
   
10. Now you need to create a service account. Click on the Menu Icon, select IAM & Admin, then select Service Accounts
    
    
11. Click Create Service Account. Fill in the Name, ID and the Description and click Create And Continue
    
    
12. Assign the service account the Role “Service Account Token Creator” from the drop-down menu and click Continue
13. Click on Done. The Service account should be ready in the list of service accounts. Press “Manage Details” to collect the needed info and to create a P12 key

14. Create a P12 key by clicking on keys, then add key och choose P12. Save this key as it will be used for later.
    
    

15. Take a note of the “Client ID” and the service account email address as they will be needed in later steps.
    
    
16. Now you need to Grant the service account API Access permissions, to do so, navigate to https://admin.google.com and click on Security, select Access and data control and then select API controls
    
    
17. Select Manage Domain Wide Delegation
    
    
18. Under the API Clients ID, Add a new client and use your service account Client ID. Copy and paste the following strings to OAuth scopes then press Authorize
    

    https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/gmail.send

    

Create & Configure Resource Calendars

1. To configure the global resource sharing and create a new resource, navigate to https://admin.google.com . Select Apps and then Calendar
   
   
2. Select External Sharing option, then set external sharing options for primary calendars to "only free/busy information (hide events details)"
   
   
3. The next step is to Create one or more calendar resource.To do so, navigate to “Directory > Buildings and resources > Manage resources”
   
   
4. Click “Create a new resource” create building then create rooms
   
   
5. Add the details for your resource and then "Add Resource"
   
6. Go to https://www.google.com/calendar and in the calendar side menu next to "Other calendars" press the + icon and browse for your newly created Resource and click the check box icon
   
   
7. Select the newly created resource calendar from "My Calendar list" and select the menu icon, then “Settings and Sharing”
   
   
   
8. Make sure to add the service account which will has settings of show free/busy.
   
   

9. You will also need to grant the admin account "make changes to events" or "make changes and manage sharing". We strongly recommend to create a new admin user specified for Humly use, as super admin could cause some issues ahead

10. Note: If you require PIN or RFID authentication to book you will need to add the users that can book with the permission "Make Changes to Events"
    
    
11. Repeat the previous step for all resources in the project.