Domain resources, rooms & calendars

Calendar API offers several concepts that are primarily useful for Google Workspace customers. These customers often have resources—rooms, projectors, and so forth—that they may wish to book for specific events. Furthermore, it’s common to build internal apps that need access to all user calendars in a domain, for example to add corporate events to them.

Domain resources & rooms

You can book resources and rooms by adding them to events as attendees, using their email address. When they receive the invitation, they automatically accept or decline the event based on the availability and access right of the inviting user.

Note: The Calendar API does not offer a way to create resource calendars. To do this, you need to use the Directory API's Calendar Resource object. The calendarId corresponds to the resourceEmail field of the Calendar Resource representation.

Accessing domain calendars as an app

An app can access domain-owned calendars without requiring user credentials if it authenticates using a service account. The service account must have the necessary access using domain-wide authority delegation. In order to impersonate a user account, specify the email address of the user account with the setServiceAccountUser method of the GoogleCredential factory.