Calendar API Resource Types
Stay organized with collections
Save and categorize content based on your preferences.
Calendar API background
Calendar concepts
Google Calendar is built on several basic concepts:
- Event
- A single event on a calendar containing information such as the title of event, start and end times, and attendees.
- Calendar
- A single calendar entry containing metadata for the calendar such as a description.
- Calendar List
- A list of all calendars on a user's calendar list in the Calendar UI.
- Setting
- A user preference from the Calendar UI, such as the user's time zone.
- ACL
- A single access control rule containing information such as the type and scope of the rule.
Calendar API data model
A resource is an individual data entity with a unique identifier. The Calendar API operates on five types of resources:
- Event Resource
- Represents a single event on a calendar.
- Calendars Resource
- Represents metadata for an individual calendar.
- CalendarList Resource
- Represents metadata for an individual calendar that appears on the user's calendar list in the UI.
- Settings Resource
- Represents a single user preference from the Calendar UI.
- ACL Resource
- Represents an ACL.
The Calendar API data model is based on groups of resources, called collections:
- Events Collection
- Consists of all the Event Resources within a specific Calendar Resource.
- CalendarList Collection
- Consists of all the CalendarList Resources for a specific user.
- Settings Collection
- Consists of all the Settings Resources for a specific user.
- ACL Collection
- Consists of all the ACL Resources applied to a specific calendar.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Calendar API Resource Types\n\nCalendar API background\n-----------------------\n\n### Calendar concepts\n\nGoogle Calendar is built on several basic concepts:\n\nEvent\n: A single event on a calendar containing information such as the title of event, start and end times, and attendees.\n\nCalendar\n: A single calendar entry containing metadata for the calendar such as a description.\n\nCalendar List\n: A list of all calendars on a user's calendar list in the Calendar UI.\n\nSetting\n: A user preference from the Calendar UI, such as the user's time zone.\n\nACL\n: A single access control rule containing information such as the type and scope of the rule.\n\n### Calendar API data model\n\nA resource is an individual data entity with a unique identifier. The Calendar API operates on five types of resources:\n\nEvent Resource\n: Represents a single event on a calendar.\n\nCalendars Resource\n: Represents metadata for an individual calendar.\n\nCalendarList Resource\n: Represents metadata for an individual calendar that appears on the user's calendar list in the UI.\n\nSettings Resource\n: Represents a single user preference from the Calendar UI.\n\nACL Resource\n: Represents an ACL.\n\nThe Calendar API data model is based on groups of resources, called collections:\n\nEvents Collection\n: Consists of all the Event Resources within a specific Calendar Resource.\n\nCalendarList Collection\n: Consists of all the CalendarList Resources for a specific user.\n\nSettings Collection\n: Consists of all the Settings Resources for a specific user.\n\nACL Collection\n: Consists of all the ACL Resources applied to a specific calendar."]]
