Google Calendar API overview

The Google Calendar API is a RESTful API that can be accessed through explicit HTTPcalls or using the Google Client Libraries. The API exposes most of the featuresavailable in the Google Calendar Web interface.

Following is a list of common terms used in the Google Calendar API:

Event
An event on a calendar containing information such as the title, start and endtimes, and attendees. Events can be either single events orrecurringevents. An event isrepresented by anEvent resource.
Calendar
A collection of events. Each calendar has associated metadata, such ascalendar description or default calendar time zone. The metadata for a singlecalendar is represented by aCalendar resource.
Calendar List
A list of all calendars on a user's calendar list in the Calendar UI. Themetadata for a single calendar that appears on the calendar list is representedby aCalendarListEntry resource.This metadata includes user-specific properties of the calendar, suchas its color or notifications for new events.
Setting
A user preference from the Calendar UI, such as the user'stime zone. A single user preference is represented by aSetting Resource.
ACL
An access control rule granting a user (or a group of users) a specified levelof access to a calendar. A single access control rule is represented by anACLresource.

Related topics

Want to see the Google Calendar API in action?
The Google Workspace Developers channel offers videos about tips, tricks, and the latest features.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-11 UTC.