This page contains release notes for features and updates to the Calendar API. We recommend that Calendar API developers periodically check this list for any new announcements.
To get the latest product updates delivered to you, add the URL of this page to your
reader, or add the feed URL directly:
February 07, 2024
The following changes will take effect on March 11, 2024:
- The use of event type filters will be considered when reviewing quota increase requests. Before you request a quota increase, make sure you specify the event types you need as a parameter for your application.
events.watchwill use the same default event type filter.
- To help with error handling, improved error messages will be returned when unsupported operations are attempted on special event types, such as working location, out-of-office, and focus time events.
For more information, refer to the following:
February 06, 2024
Generally available: The
events.watch() method now supports the
eventTypes field as a query parameter so that you can subscribe to changes about specific Calendar events, such as working location, out-of-office, or focus time events. For details, see the reference documentation.
December 07, 2023
To fix a bug that prevented events of
eventType != 'default' from importing, we updated the code sample in Populate a team vacation calendar, the popular Apps Script + Calendar API solution. Review the code change in GitHub.
August 17, 2023
Generally available: Reading and updating working locations using the Google Calendar API is now generally available. For details, see Manage working locations for Google Calendar users.
August 22, 2022
Developer Preview: The Google Calendar API now supports reading and updating working locations. For details, see Manage working locations for Google Calendar users.
March 23, 2022
The Calendar API now supports custom attachments. See Calendar add-ons for more information.
October 20, 2021
The Calendar API now exposes a new
eventType. The new type is called
focusTime and allows users of the API to distinguish the special focus time events. For more information, see the API reference.
May 18, 2021
Two new quotas now exist for the Calendar API in addition to the general Calendar usage limits:
- Per minute per project.
- Per minute per project per user.
See Manage quotas for more information.
February 08, 2021
Starting today, all existing and new out of office events will be updated to set the organizer to
email@example.com instead of the Calendar owner. It may take 2-3 weeks for this change to fully roll out.
You can use the calendarId from the API endpoint
https://www.googleapis.com/calendar/v3/calendars/calendarId to identify the owner of the out of office event.
February 01, 2021
The Calendar API now exposes a new field for events. The new field is called
eventType and allows users of the API to distinguish special event types, such as
outOfOffice. For more information, see the API reference.
January 11, 2021
From now, we require
conferenceData to be consistent with
conferenceData.conferenceSolution.key.type; meaning only Google Meet calls can have
conferenceData.conferenceSolution.key.type set to
hangoutsMeet. All 3P video conference providers are expected to set
September 07, 2020
Meet video conferences should be added explicitly using the following existing parameters:
conferenceDataVersionquery parameter to
conferenceData.createRequestevent property as follows:
conferenceData.createRequest.requestIdto unique request id.
We stopped auto-populating Meet for API calls (such as
Events.insert) to prevent Meet conferences being added unintentionally via 3rd parties.
March 16, 2020
Service accounts created on or after March 2, 2020 are only able to invite guests using domain-wide delegation of authority.
September 27, 2019
The Calendar API allows attaching a conference data of type
addOn to a new or existing event using
November 19, 2018
Starting on January 7, 2019, notifications and reminders using the
sms method type will be ignored. The API calls setting such notifications and reminders will still succeed and modify all the other fields.
Since Calendar offers in-app notifications, you can still get notified, regardless of your device or connection. For more information see Google Calendar SMS notifications to be removed.
October 31, 2018
The Calendar API now supports four new OAuth scopes. The scopes allow your application to limit access to only the data you really need. See Authorizing Google Calendar API Requests for more details.
October 02, 2018
A more flexible approach to sending event change notifications is now available through the
sendUpdates parameter. The new parameter lets you set event change notifications to do one of the following:
- Notify all the event guests.
- Notify only the guests who are not using Google Calendar.
- Completely suppress the notifications, for example, during a migration.
Now it is possible to always keep in sync guests who use other calendaring systems, without sending too many non-mandatory emails to Google Calendar users.
March 22, 2018
Support for the JSON-RPC protocol and Global HTTP batch endpoints has been deprecated, and will be fully discontinued on March 25, 2019. This change is being made to the Google API infrastructure and as such affects multiple Google APIs, including Calendar v3.
For more information and migration instructions, see the Discontinuing support for JSON-RPC and Global HTTP Batch Endpoints blog post.
July 12, 2017
Hangouts and Google Meet conferences are now supported in Calendar events via the
conferenceData field. You can:
- Read conference data associated with events.
- Copy conference data from one event to another.
- Request new conference generation for an event.
- Clear conference data associated with events.
To learn more, see Create Events.