Calendar API Resource Types

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.