This page lists new features and behavior changes in Calendar v3 API. It is intended to help developers identify recent changes in behavior. Major changes to the Calendar API are also announced on the Google Developers Blog.
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
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 8, 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 1, 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
outOfOffice. For more information, see the API
January 11, 2021
From now we require conferenceData to be consistent with
conferenceData.conferenceSolution.key.type; meaning only Google Meet calls can
conferenceData.conferenceSolution.key.type set to hangoutsMeet. All 3P
video conference providers are expected to set
September 07, 2020
Bug fix: Meet video conferences should be added explicitly using the existing parameters (see steps 1 and 2 below):
conferenceDataVersionquery parameter to
conferenceData.createRequestevent property as follows:
conferenceData.createRequest.requestIdto unique request id.
We stopped auto-populating Meet for API calls (such as
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 2, 2018
A more flexible approach to sending event change notifications is now available
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 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
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.