Booking System Preparation - Google Workspace

This article will cover the process of preparing Google Workspace for HCP integration, 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 otherwise, you can go to Menu Icon > API Manager > 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” for the project
   
10. Now you need to create a service account, click on the Menu Icon, select IAM & Admin, then select Service Account
    
11. Click Create Service Account, fill in the Name, ID and the Description and click Create
12. Assign the service account the Role “Service Account Token Creator” from the drop-down menu and click Next
13. Press on Create Key and select P12 and click create.
    Save the P12 key as it will be used later.
14. Click on Done, the Service account should be ready in the list of service accounts, press “Edit” to collect the needed info
15. Take a note of the “Client ID” and the service account email address as they will be needed in later steps.
16. Click on “Show Domain Wide Delegation” and checkmark “Enable”, add a product name of your choice, then click “Save”
    
17. Now you need to Grant the service account API Access permissions, to do so, navigate to https://admin.google.com and select Security
    
18. Select API Controls then Manage Domain Wide Delegation
    
    
19. 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 then select “Apps”
   
   
2. From the Apps page, select Google Workspace then Calendar
   
3. Select External Sharing option, set external sharing options for primary calendars to "only free/busy information" 
   
4. The next step is to Create one or more calendar resources, to do so, navigate to “Resources”, if you already have resources configured, you can skip the following steps and move to install the HCP. 
   
5. Click “Create a new resource” create building then create rooms
   
6. Add the details for your resource and then "Add Resource".
   
7. Go to https://www.google.com/calendar and in the calendar side menu under "Other calendars" press the + icon and browse for your newly created Resource and click the check box icon.
8. Select the newly created resource calendar from the list and select the menu icon, then “Settings and Sharing”
   
   
   
9. Make sure to add the service account which will has settings of show free/busy, and the users “Make Changes to Events”.
10. Note: If you require PIN or RFID authentication to book you will need to add the users that can book ith "Make Changes to Events" access.
11. 
12. Repeat the previous step for all resources in the project.