Google Calendar

The Google Calendar adapter uses the Google Calendar API to look up meetings and room bookings in Google Workspace.

Prerequisites

• Google Workspace (not personal Gmail accounts).
• A Google Cloud project with the Calendar API enabled.
• OAuth2 credentials (client ID and client secret).
• Domain-wide delegation may be required for accessing other users' calendars.

Setup

1. Create a Google Cloud project (or use an existing one):

   • Navigate to Google Cloud Console → APIs & Services.
   • Enable the Google Calendar API.
   • Configure the OAuth consent screen (internal app for your organization).

2. Create OAuth2 credentials:

   • Navigate to Credentials → Create Credentials → OAuth Client ID.
   • Application type: Web application.
   • Authorized redirect URI: https://<your-atrium-domain>/api/v1/integrations/oauth/callback.
   • Note the client ID and client secret.

3. Configure in Atrium:

   • Navigate to Settings → Integrations → Calendar.
   • Select Google Calendar.
   • Enter the client ID and client secret.
   • Click Authorize — you'll be redirected to Google to grant access.

4. Select room calendars: After authorization, configure which room resource calendars Atrium should query for room availability.

How it works

The adapter follows the same pattern as the Exchange adapter:

1. At check-in, query the host's calendar for events around the expected arrival time.
2. Match events by attendee email or time/subject.
3. Extract room information from the event's location or room resource.
4. Display on the kiosk completion screen.

Considerations

• Google Workspace only: Personal Google accounts don't support room resources or domain-wide delegation.
• Admin consent: A Workspace admin may need to approve the OAuth consent screen for your domain.
• Push notifications: Google Calendar supports push notifications via webhooks for change tracking. The Atrium server must be HTTPS-accessible from Google's infrastructure.