Resource Booking Setup - Google Calendar

1 1) Setup Calendar Sharing
- 1.1 Calendar Sharing Options
  - 1.1.1 a) Public Calendar:
  - 1.1.2 b) Private Calendar - Individual Share:
  - 1.1.3 c) Private Calendar - Organisation Wide (Coming Soon):
2 2) Enabling on the maps
3 3 Data access

Welcome to the Mazemap Resource Booking feature setup guide. This feature simplifies space bookings in your hybrid work environment, allowing you to book various spaces such as rooms, workspaces, and desks. Follow the steps below to get started:

1) Setup Calendar Sharing

MazeMap supports both Public and Private sharing of calendars for resource booking.

Go to your Calendar settings by clicking here.
Check if the room you want to book is listed under "Settings for my calendars." If it's already there, you can skip to Step 3.

If not, follow these steps:

1) Click on "Add calendar."

2) Select "Subscribe to calendar" or "Browse resources" to find meeting rooms in your organisation.

3) Search for the room name you wish to add. Once found, it will appear under "Settings for my calendars."

Edit Calendar Settings

Calendar Sharing Options

a) Public Calendar:

If you want your room calendar to be available to the public, room booking visualisation will work by default. Scroll down to "Access permissions" and make sure the "Make available to public" box is checked.

b) Private Calendar - Individual Share:

If you choose to have a private room calendar, you must share it individually with MazeMap for room booking visualization to work.

Scroll down to "Access permissions" and ensure the "Make available to public" box is unchecked.
Scroll down to "Share with specific people" and select "Add people."
Add room-booking@mm-prod-app.iam.gserviceaccount.com and select "send." Users with login credentials will now be able to see the room schedule on your map.

c) Private Calendar - Organisation Wide (Coming Soon):

Documentation coming soon

2) Enabling on the maps

Once the calendars have been shared, compile a list of the resources that need to be activated that includes;
1. Campus
2. Building
3. Floor
4. Room ID, POI ID (the poi in MazeMap
5. resource email address
Log a support request including the list of resources.

That's it! You've successfully set up the Mazemap Resource Booking feature with Google Calendar, with various options for calendar sharing, including public, individual, or complete sharing using Google Workspace Domain-Wide Delegation.

If you encounter any issues or have questions, don't hesitate to contact our support team.

3 Data access

Scopes:

SCOPES = [
    "https://www.googleapis.com/auth/calendar.events",
    "https://www.googleapis.com/auth/calendar",
    "https://www.googleapis.com/auth/admin.directory.group.readonly",
]

USER_SCOPES = [
    "https://www.googleapis.com/auth/calendar",
    "https://www.googleapis.com/auth/userinfo.email",
]

Endpoints:

Subscribe to changes
- https://developers.google.com/calendar/api/v3/reference/events/watch
Get information about when resources are free/busy
- https://developers.google.com/calendar/api/v3/reference/freebusy/query
Get users reservations
- https://developers.google.com/calendar/api/v3/reference/events/list
Get a single event
- https://developers.google.com/calendar/api/v3/reference/events/get
Booking a resource
- https://developers.google.com/calendar/api/v3/reference/events/insert
Update booking
- https://developers.google.com/calendar/api/v3/reference/events/update
Cancel booking
- https://developers.google.com/calendar/api/v3/reference/events/delete

Other references:

https://support.google.com/calendar/answer/37082?hl=en

MazeMap Customer Self Help