Google Workspace

Google Workspace
Setup Guide

Connect The Room Display to Google Calendar for your meeting rooms

Quickest Way to Get Started

Just sign in with your Google Workspace account. No admin configuration needed for basic functionality.

1

Download and Open the App

Download The Room Display from the App Store on your iPad.

2

Choose Google Workspace

Select Google Workspace as your platform, then choose Sign in with Google.

3

Sign In and Grant Permissions

Sign in with your Google Workspace account and approve the requested permissions (calendar access and room discovery).

4

Select Your Room and Save

Fetch rooms, select your meeting room from the dropdown, and tap Save.

Service Account (Advanced)

Advanced users only. This method requires Google Workspace admin access. Use OAuth above unless you have specific enterprise requirements like unattended operation without a user account.

1. Create a Google Cloud Project

  1. 1. Create a new Google Cloud project (e.g. TheRoomDisplay)
  2. 2. Enable Google Calendar API and Admin SDK API
  3. 3. Create a service account and enable domain-wide delegation
  4. 4. Generate a JSON key file (Keys tab → Add Key → Create new key → JSON)
  5. 5. Copy the service account's Client ID

2. Configure Domain-Wide Delegation

  1. 1. Go to Domain-wide Delegation in Google Admin Console
  2. 2. Click Add new and paste your service account's Client ID
  3. 3. Add these OAuth scopes:
https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

3. Configure the iPad App

  1. 1. Select Google Workspace → Service Account
  2. 2. AirDrop the JSON key file to the iPad, or tap Import Service Account JSON
  3. 3. Enter your Google Workspace admin email address
  4. 4. Tap Test Connection, then fetch rooms and select your room

Creating Room Resources

Meeting rooms must be configured as calendar resources in Google Workspace for The Room Display to discover them.

Create a Room Resource

  1. 1. Go to Google Admin Console → Calendar Resources
  2. 2. Click Add new resource
  3. 3. Set Category to "Meeting Room" (or similar), give it a name and optional building/floor info
  4. 4. Save — a calendar email will be generated automatically

Propagation delay: New room resources can take up to 72 hours to become fully accessible via the API. If your room doesn't appear in the app yet, enter the room's email address manually during setup.

Troubleshooting

"API has not been used" or "API is disabled"

Solution: Enable the Google Calendar API and Admin SDK API in Google Cloud Console. Wait 1-2 minutes for them to activate.

"No room calendars found"

Solution: Verify room resources are created in Google Admin → Calendar Resources. New rooms can take up to 72 hours to propagate. Enter the room email manually in the meantime.

"unauthorized_client" error (Service Account)

Solution: Verify domain-wide delegation is enabled and that the Client ID and scopes match in the Admin Console. Wait 2-10 minutes after making changes.

"Permission denied" or 403 errors

Solution: Make sure you granted all requested permissions during OAuth sign-in. For Service Account, verify both scopes are added to domain-wide delegation. Try signing out and signing in again.

Ready to transform your meeting rooms?

Purchase The Room Display from the App Store today

Buy Now