Calendar API는 주로 Google Workspace 고객에게 유용한 여러 개념을 제공합니다. 이러한 고객은 특정 이벤트를 위해 예약할 수 있는 리소스(회의실, 프로젝터 등)를 보유하고 있는 경우가 많습니다. 또한 도메인의 모든 사용자 캘린더에 액세스해야 하는 내부 앱을 빌드하는 것이 일반적입니다(예: 회사 일정을 추가하는 경우).
도메인 리소스 및 회의실
이메일 주소를 사용하여 참석자로 일정에 리소스와 회의실을 추가하여 예약할 수 있습니다. 초대를 받으면 초대 사용자의 일정 및 액세스 권한에 따라 자동으로 일정을 수락하거나 거부합니다.
앱으로 도메인 캘린더에 액세스
앱이 서비스 계정을 사용하여 인증하는 경우 사용자 인증 정보 없이 도메인 소유 캘린더에 액세스할 수 있습니다. 서비스 계정에는 도메인 전체 권한 위임을 사용하여 필요한 액세스 권한이 있어야 합니다. 사용자 계정을 가장하려면 GoogleCredential 팩토리의 setServiceAccountUser 메서드로 사용자 계정의 이메일 주소를 지정합니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Domain resources, rooms & calendars\n\nCalendar API offers several concepts that are primarily useful for\n[Google Workspace](https://workspace.google.com/)\ncustomers. These customers often have\nresources---rooms, projectors, and so forth---that they may wish to\nbook for specific events. Furthermore, it's common to build internal apps that\nneed access to all user calendars in a domain, for example to add corporate\nevents to them.\n\nDomain resources \\& rooms\n-------------------------\n\nYou can book resources and rooms by adding them to events as attendees, using\ntheir email address. When they receive the invitation, they automatically\naccept or decline the event based on the availability and access right of the\ninviting user.\n| **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](/workspace/admin/directory/reference/rest/v1/resources.calendars) object. The calendarId corresponds to the resourceEmail field of the Calendar Resource representation.\n\nAccessing domain calendars as an app\n------------------------------------\n\nAn app can access domain-owned calendars without requiring\nuser credentials if it authenticates using a [service\naccount](/identity/protocols/OAuth2ServiceAccount). The service account must\nhave the necessary access using [domain-wide authority\ndelegation](/identity/protocols/OAuth2ServiceAccount#delegatingauthority). In\norder to impersonate a user account, specify the email address of the user\naccount with the `setServiceAccountUser` method of the `GoogleCredential`\nfactory."]]